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SECTION 1 
INTRODUCTION 



SCOPE OF HANDBOOK 



This handbook is a detailed reference manual for the 
PRIME 200 Macro Assembly Language. It is organized in 
six sections for ease of reference. 

This section introduces the assembly language, describes 
the action of the program, and discusses the interaction 
of the assembler with its companion program, the PRIME 
200 Linking Loader. 

Section 2 discusses statement formats and language features 
common to all types of assembly language statements. 

Section 3 contains the rules for forming instruction 
statements using PRIME 200 instruction mnemonics. 

Section 4 describes pseudo-operations (directives to the 
assembler and loader) . 

Section 5 defines the Macro facility, a way to define 
program statements that can be called for execution by 
easily interpreted English language statements. 

Section 6 defines commands used to invoke functions of 
RDALN, routine that merges lines from two or more source 
files during assembly. 

The handbook is concluded by several appendices and a 
detailed subject index. 



REFERENCE DOCUMENTS 

The following publications are recommended to supplement 
this handbook: 

PRIME 200 Programmer's Reference Manual 

PRIME 200 Operator's Guide 

PRIME 200 DOS Reference Manual 

PRIME 200 RTOS Reference Manual 
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PRIME 2 00 ASSEMBLY LANGUAGE 



The PRIME 200 Macro Assembly Language has the usual 
provisions for symbolic instructions, symbolic addresses, 
and control pseudo-operations expected by computer 
users. It also offers many other advanced features: 



* Free Format: 



Source statements are independent 
of column boundaries and permit 
free use of spaces. Multiple 
statements per line are permitted, 
and statements may be continued from 
line to line. 



Symbols : 



Symbols or Variables assigned to 
address and data locations may contain 
up to 32 characters. 



* Constants: 



Wide variety of constant forms: 
decimal, octal, hexadecimal, ASCII, 
double precision, floating point, 
literals. 



* Expressions 



Symbols and constants may be linked 
in expressions using 14 different 
arithmetic, logical, and shift 
operators . 



* Pseudo-Operations 



Over 50 pseudo-operations for assembly 
control, listing control, loader con- 
trol, data definition, variable 
definition, storage allocation, program 
linking, and conditional assembly. 
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* Macro Facility: Programmer can define macros to be 

called by application-related 
language statements. Arguments are 
identified by position or flagged 
by key words. Looping, local 
references, and nesting are permitted, 



The main purpose of an assembly language is to reduce the 
clerical chores required to prepare a binary program that 
can be executed by the computer. Of course, it is possible 
to look up the binary code for a given instruction and key 
it into a memory location using front panel controls. For 
example, an instruction to load the A register from 
location '377 of sector would be the octal code '004377. 
The octal code for any PRIME 200 instruction can be determ- 
ined from the Programmer's Reference Manual. (Also see 
Table 3-1.) 

But manual key- in of programs is tedious, error prone, and 
the bare binary codes can only be interpreted by a pains- 
taking analysis. This mode of program entry is usually 
limited to key-in loader bootstrap programs and short test 
sequences. A symbolic assembly language has become the 
universal means of preparing programs of any size. An 
assembly language provides a vocabulary of symbolic, or 
mnemonic, codes - and a grammar of statement forms - to 
represent machine language instructions in a format that 
is easily read and interpreted by the original programmer 
or any other reader familiar with the language. 

Basic Assembly Language Elements 

Figure 1-1 illustrates a section of a typical program 
written in PRIME 200 Macro Assembly Language. The basic 
unit of information processed by the PRIME 200 assembler 
is the line . When originated at an ASR-33 Teletype key- 
board, FTTne consists of up to 72 ASCII characters (75 
for ASR-35) occurring between carriage return - line feed 
characters. When input is from unit record equipment, a 
line consists of an 80-character card field. 

There are statement lines, comment lines and change page 
heading lines. A statement line has a space in column 1, 
an optional label, one or more statements, and an optional 
comment field. A comment line has an asterisk in column 1; 
the rest of the line is ignored except for listing purposes, 
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A change page heading line has an apostrophe in column 1; 
the rest of the line becomes the page heading for all 
subsequent listing pages. 

A label is an ASCII character string that identifies the 
locations count of the first statement in the line. 
Examples are the name of the entry point for a subroutine 
or the symbolic name of a storage location. These and 
other common features of the language are described in 
detail in Section 2. 

The PRIME 200 processes four types of stateme nts, each 
with a unique format: instructions, pseudo-operations 
macro calls, and file merging commands. These are * * 
described in detail in Sections 3 through 6, respectively 
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*SHORT DEMO PROGRAM EXAMPLE 





RBS 






ORG 


" 3000 




CRA 




c 


01" fl 
SRI 


•" 1720 




■TMP+ 


DOS 


f: 


IRX 






JMP 


fl 


B 


IRX 






JMP 


B 




AOA 






FAIL 






..TUP 


c 


DOS 


OCT 
END 


30888 


FND 







DISPLAY Fl REG IN PANEL IND 



DATA INDICATORS COUNT SLOWLV 
DELIBERATE ERROR LINE 



Figure 1-1. Example o£ PRIME 200 Macro 
Assembly Language Statements 
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Symbolic Instructions 

The A Register load operation mentioned above can be 
represented in the form: 

LDA '377 

where LDA is the mnemonic of the LDA instruction and 
'377 is the octal representation of the memory address 
where the data is located. The programmer may also control 
the flag and tag bits symbolically, as in: 

L^A* '37 7,1 

where the asterisk specifies indirect addressing and the ,1 
specifies indexing. After being processed by the assembler 
and loader, this statement would be converted into a 
binary instruction word, shown in Figure 1-2. The resulting 
word would have an octal value of '144377. 
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LDA* 


•377# 


I 


1 1 




















1 

1 . ^ 


1 


f 






1 



~> 



I 1 I 
I I 




J I 



I I 



I I 

I 



I I I 



h 



1 X H~C0DE 



■ADDRESS- 



SECTOR B IT 
(DETERMINED BY LOADER) 



Figure 1-2. Interpretation of 
Symbolic Instruction. 
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Constants, Literals, Variables, and Expressions 

This assembler permits a variety of forms for data 
constants, thereby eliminating conversions from decimal 
to binary, octal, or hexadecimal. Examples: 



'123 -'777 '-1777 octal 

$89AB -$FFFF $-00FF Hexadecimal 

1234 -9999 32767 Decimal 



The constant forms shown above are all single-precision 
(ie. are converted to a single 16-bit data word - 15 
magnitude bits plus sign). For decimal numbers, double 
precision and floating point quantities may be specified: 



1.23BB6 1.23EE2BB6 Fixed Point 

Double 
Precision 



1.23E2 1.1092 Floating Point 

Single Precision 



1.23EE2 Floating Point 

Double Precision 



The assembler also accepts ASCII constants: 



C'A 1 (The letter A, left 

justified in a 16-bit 
word) 



CAB' (The letters A and B 

packed into a 16-bit word.) 
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Another form of constant with a self -defining symbolic 
name is the literal : 

= '77 Octal 

= $39FB Hexadecimal 

= 199 Decimal 

= CX' C one character) ASCII 

- C'XY 1 (two characters) 

Variables , also called symbols or symbolic names, may 
be assigned to identify memory locations. Symbols are 
defined by being used in the label field of a statement, 
or by the EQU or SET pseudo-operations. The assembler 
accepts alphanumeric symbols of up to 32 characters: 

A 

ALPHA 

ABCDEFGHIJKLMNOPQRSTUVWXYZ1234 56 

Expressions may be formed using constants or variables, 
linked by 14 different arithmetic, logical and shift 
operators : 

A + 3 ALPA*(4 - B) A .LS.(ALPA/5) 

A .AND. '3737 BETA .GE.A+$FF 

Symbolic Names 

Symbolic names may be coined by the programmer and assigned 
to memory locations, so that data locations and program 
entry points can be specified by self-explanatory codes 
rather than numerical values. For example, the load A 
instruction could be coded as 

LDA* DATA,1 

provided the symbol DATA is defined somewhere in the 
program as equal to memory location '377. During the first 
pass of an assembly operation, the assembler builds a 
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symbol table that relates each symbol (also called 
variable, or symbolic name) to the location where it 
is defined. On the second pass, the numerical value 
of each symbol is substituted for the alphanumeric 
expression, wherever it is used in an address field, 

Symbolic names can, in many cases, be modified or 
processed by arithmetic operators, as in 

LDA DATA-1 

LDA DATA*4-1 



^seudo Operations 

In addition to instruction statements, the assembly 
language provides pseudo operation statements that 
#ive the programmer control of the assembly process 
itself and of the loading operation that follows 
assembly . 

In the example of Figure 1-1, several pseudo-operations 
are used. The program example begins with an ABS, 
specifying absolute loading mode. An ORG statement sets 
the assembler's location count (discussed later) to 
'3000. A OCT statement equates the symbol DOS to the 
octal quantity '30000. The program example ends with a 
mandatory END statement. These and many other pseudo- 
operations are described in detail in Section 4. 



Macro Facility 



The macro feature of this assembler enables the programmer 
to define functions that can be expressed in easily 
interpreted English (or other) language statements: 



TRANSFER DATA TO DAC 

TURN ON VALVE 312 

Statements of this sort are made possible by a process 
called macro definition. With the aid of the MAC and 
ENDM pseudo-operations, a system programmer can create 
macro prototypes. 
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The TRANSFER statement, above, might be defined by the 
following sequence of statements: 

TRANSFER MAC TO 

LDA <1> 

OTA <2> 

ENDM 

The MAC pseudo-operation introduces the macro definition 
by assigning the name TRANSFER to the macro and identifying 
the word TO as a dummy word (a word that can be used to 
increase the intelligibility of macro calls without 
being mistaken for an argument) . 

Variable fields of the LDA and OTA instructions call for 
arguments, symbolized by numerals enclosed within angle 
brackets. Values for arguments are supplied by the macro 
call statements. For example the statement TRANSFER DATA 
to DAC calls for the TRANSFER macro to be assembled, with 
the symbol DATA substituted for argument <1> , and the 
symbol DAC substituted for argument <2 > . The TRANSFER 
macro would then be assembled as follows: 



After a set of macros has been defined by a system-level 
programmer, a specialist in a particular application field 
can formulate macro calls in plain language to solve his 
application problems, without becoming involved in the 
details of assembly language programming. Definition, 
listing, and assembly are discussed in detail in Section 5. 
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USING THE MACRO ASSEMBLER 



The Macro Assembler translates ASCII source files and 
produces an object file, for processing by the Linking 
Loader, and an optional listing file, to be printed as 
a record of the source language statements and the 
octal codes to which they have been translated. The 
files may be printed or punched on tape during assembly 
or they may simply be stored (on disk, for example) until 
they are needed. Device options are specified by register 
settings at the start of assembly. 

Two-Pass Assembly 

The assembler program itself is first loaded into 
computer memory. The assembler occupies approximately 
4K memory locations; the absolute location in CPU 
memory depends on the amount of memory available, and 
the type of system (DOS-based, stand-alone, etc.). 

To use the assembler, the operator sets up an input 
device containing a source program file. Devices to 
receive the object files and listing output (optional) 
are specified by entries in CPU registers and the 
assembler is started. 

This two-pass assembler first reads the source file to 
locate and assign values to any alphanumeric variables 
(symbols) used in instruction or pseudo-operation 
variable fields. The source file is then returned to 
the beginning and read again. On the second pass, the 
assembler substitutes numerical values for all variables 
and evaluates expressions, thus converting symbolic 
references to 16-bit binary quantities. The assembler 
then outputs the object file and a listing, if requested. 

Object Output 

The object output of the assembler is in a special format 
suitable for input to the Linking Loader. Instructions, 
data constants, and directives to the Loader are encoded 
as blocks of data in various sizes and formats. (For 
details, see Appendix F.) When object files are punched 
on paper tape, they are in an "invisible" character 
format; none of the frames punched on the tape will cause 
printing on an ASR. (This saves paper by eliminating 
nonsense printout when the ASR is used as the loading 
device . ) 
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Listing Format 

The object file is in an arbitrary binary format that is 
meaningful only to the loader, but the optional listing 
file pairs an octal representation of the object code 
with the actual source input statements they represent, 
in a format that is meaningful to the programmer. 

Figure 1-3 shows a section of a typical assembly listing 
and defines the main features. The format is organized 
in columns, but when long labels or other free format 
features are encountered, extra space is used as required. 

Each page of the listing begins with a header provided 
by the source statements, and a sequential page number. 
The first statement in a program is used as the initial 
page header, unless it starts with a quotation mark (") . 
If column 1 of any statement contains an apostrophe ('), 
columns 2-72 of that statement become the title for all 
pages that follow until a new title is specified. 

Columns 1-4 are reserved for error flags. (See Appendix G.) 
Columns 5-9 contain an octal assignment address location 
count and columns 11-19 contain the octal object code 
generated by each statement. Columns 21-26 contain a 
decimal line sequence number and columns 28-108 contain 
the source statement (ASCII Image) truncated if necessary 
depending on printer limitations 



lO . 
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+SHORT DEMO PROGRAM EXAMPLE 



DISPLfiV fl REG IN PANEL IND 



AE3S 

ORG ■'' 30O0 

CRA 
C 01 A -' 1720 

SRI 

Jl-'iP* DOS 
A IRK 

..IMP A 

b jj'.p B DELIBERATE ERROR LINE 

AOA 
FAIL 
J MP C 
DOS OCT 70O00 
END 



DATA INDICATORS COUNT SLOWLY 



A 00 70 04 001.0 001 ■ 

.B 7 '" ■' 1 v : 001 

C 003001 0007' 00 If 

dos 003O17' 0009 001; 



0081 ! TNFS MITH ERRORS '.'VERSION P. 01 :■ 



Figure 1-3: Example of Assembly Listing 
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Location Count 

The assembler assigns a sequential location count to each 
element in the object code that will be converted to a 
CPU memory location. (Instruction statements always 
generate one line of code; data defining pseudo-operations 
may generate one or more lines, depending on the constant 
format. ) 

The starting value for the location count is zero, unless 
another origin is specified by the ORG pseudo-operation. 
The assembler normally increments the location count by 1 
after each entry but a new count can be established by 
another ORG statement at any point in a program. In the 
example of Figure 1-3, an ORG statement sets the origin 
to '3000 and the location count is stepped sequentially 
from that value. 

Figure 1-3 also shows how symbols are assigned numerical 
values in relation to location counts. The symbol A for 
example, is equated to '3000 when it is used in the label 
field of the IRS instruction in that location. 

The address field of the JMP instruction in location 3005 
contains a reference to the symbol A. Notice that the JMP 
instruction is assembled with the assigned value of A 
C'3004) in its address field. 

Symbol Cross Reference Listing 

At the end of the assembly listing appears a cross- 
reference listing of each symbol's name (in alphabetical 
order), the symbol's assignment address or value, and a 
list of all reference to that symbol. Each reference is 
identified by a 4-digit decimal line number. 

The information necessary for the cross-reference listing 
is stored in the symbol table. If, during assembly, the 
symbol table becomes full, cross-reference information is 
sacrificed in order for assembly to continue. If this 
occurs, the cross-reference listing will contain only 
the alphabetic symbol names and their assignment addresses 

If listing is inhibited (by NLST pseudo-operation), the 
cross reference listing is not listed. The same listing 
device is used for; the cross-reference as is used for the 
Pass 2 assembly listing." 

The last line of the listing specifies the version of the 
assembler and the number of lines containing error flags. 
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ASSEMBLER/LOADER INTERACTION 

The Linking Loader is required to interpret the object 

code blocks, form 16-bit binary instruction and data 

codes, and load them in the proper locations of main 

memory. The actual location in which a word is loaded 

depends on whether absolute (ABS) or relocatable (REL) 

mode has been specified. (ABS is the assembler's 

default mode.) In absolute mode, the assembler-assigned 

location count becomes the actual instruction location. 

In relocatable mode, an address offset, entered into a register 

at the start mode of loading, is added to the location count. 

The E32R and E64R addressing modes further modify this procedure 

Two or more relocatable programs can be packed together anywhere 
in memory without wasted space, even though the final locations 
are unknown at the time of programming. The "linking" feature 
of the assembler-loader combination permits main programs and 
subroutines to share common data locations and entry points. 



Desectorizing and Address Resolution 

In assembly language there is no way to specify that the 
sector bit of memory reference instructions is to be set, 
except to count instructions and data locations and 
deliberately keep track of the current sector. In a 
program of any length, bookkeeping of this type would 
become tedious. Instead, the assembler and loader take 
over this function. They jointly keep track of sector 
information and set or clear the sector bit of each memory 
instruction at the time it is loaded. 

The binary object code output of the assembler includes 
a 14-bit or 15-bit address for each memory reference 
instruction, depending on whether or not extended addressing 
is in effect. (See EXD pseudo-operation). 

In 16K sfict-nrfiH, addrfis^iiKr mode (E16S) . the assemhlpr 
presents a 14-bit binary address to the loader, along 
with an indirect bit and indexing bit. As the loader 
processes the instruction, it compares the instruction's 
14-bit address with the current location count. If the 
instruction and the address are in the same sector, the 
loader truncates the address to 9 bits, loads it into 
the instruction address field (bits 8-16) and sets the 
instruction's sector bit (bit 7). 
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However, if the instruction's 14-bit address specifies 
a different sector than the one containing the instruction, 
the loader assigns a location in a table of cross-sector 
indirect words and loads the 14-bit address (plus 
indirect and indexing bits) in that location. The 
indirect bit and address field of the instruction word 
itself are set to point to the indirect word. Since 
the indexing bit is moved to the indirect location, the 
index bit of the instruction itself is cleared. 

Ordinarily, the table of indirect words begins at location 
'100 of Sector zero and grows upward as required. However, 
another base sector can be specified by the SETB pseudo- 
operation, and the starting location for the links can 
be altered by a register setting at the time of loading. 

Extended Addressing Mode 

If extended addressing mode has been set up by the EXD 
pseudo-operation, the assembler presents 15-bit addresses 
to the loader. (Bit 2 of the address is interpreted as 
a magnitude bit rather than the index bit.) The check for 
cross-sector references is made as usual, and an indirect 
link is formed if necessary. The full 15-bit address 
is stored in a resulting indirect link location (indexing 
cannot be specified) . 

It is important to specify that code be loaded in the 
mode in which it is to execute. If the source program 
contains a EXD pseudo-operation, extended addressing mode 
must also be set up for the CPU by an E32S or E32R 
instruction. 



Loading Subroutines 

If the main program calls for external subroutines, the 
loader halts and waits for the user to assign the library 
or other files containing subroutines to the input device 
already selected. The loader then identifies and loads 
every subroutine called by the main program. Subroutines 
are desectorized and linked together in consecutive 
memory locations unless new ORG values are assigned. 
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Memory Map 

At any time during loading of a series of programs and 
subroutines, the loader can be directed to print a 
memory map. The map shows the locations occupied by 
the program in memory, specifies locations for common 
storage, shows subroutine entry locations, and identifies 
subroutines that have been called but are not yet loaded. 
A memory map for the program example discussed earlier 
appears in Figure 1-4. 



LOADING AND OPERATING PROCEDURES 



Loading and operating procedures for the Macro Assembler 
vary according to the type of installation, memory size, 
and supporting software. Appropriate procedures are 
available in one of the following documents: 



PRIME 200 Operator's Guide 
PRIME 200 DOS Operator's Guide 
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*STAHT 01000 *KluH 03014 *NAMES 2003 5 *COM 23 777 
*PBRK 03014 *BASL 00100 LIST 00001 



Figure 1-4. Example of Memory Map 
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SECTION 2 
GENERAL ASSEMBLY LANGUAGE RULES 

The following language features are common to all types of 
statements. Features that are peculiar to instruction 
statements, pseudo-operation statements, and macro calls 
are defined in later Sections. 

FREE -FORM INPUT TEXT 

Input text for the PRIME 200 assembler may be prepared in 
a number of ways. Perhaps the most common is text prepared 
at a' teleprinter with the aid of the PRIME 200 text editor. 
The resulting source program exists as a file in memory or 
on the disk, and can be punched on paper tape in ASCII 
format. For text prepared in this way, the basic unit of 
information is a line , as delimited by carriage return-line 
feed (CRLF) characters. Because of the mechanical limitations 
of most teleprinter devices, lines are usually limited to 
72 or 75 characters. 

Input text may also be coded by hand on paper forms which 
are then keypunched to produce unit record cards. Each 
card is equivalent to one teleprinter line, but may contain 
up to 80 characters. 

Line Format 

PRIME-200 assembler input lines consist of labels, statements, 
and comments strung together in a free (column independent) 
format without regard for tabulation positions or arbitrary 
column boundaries. The assembler recognizes statements within 
a line, and subfields within statements, by delimiters 
consisting of spaces, colons, commas, backslash (tab character), 
and semicolons. (Labels and comments are optional.) For 
examples see Figure 2-1. 

Tahels- Labels are used to assign mnemonic codes to memory 
i !^ nc for example the name of a subroutine entry 

ocation or'thrsymb^ic'address of a constant or storage 
rill Labels are optional. If a line includes a label, 
^ first* character of the label must be in column 1 of the 
line! 5therwise e column 1 must be. blank.) labels must 
conform to the character set and size prescribed for variables. 
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SINGLE 

STATEMENT 

LINE 



MULTIPLE 
STATEMENTS 
PER LINE 



OPTIONAL I OR MORE SPACES 

\ * /i 



2 SPACES OR COL. 72 



COMMENT LINE 



LABEL 



/ / 
/ / 



STATEMENT 



/ I 



/ 



£ 



LABEL 



COLON 



STATEMENT 
\ 



STATEMENT 



ASTERISK 

\ 



COMMENTS 



MULTIPLE 
LINES PER 
STATEMENT 



LABEL 



STATEMENT 



\ 



COMMENTS 



1 



COMMENTS 



SEMICOLON 

i 



STATEMENT CONTINUED 



CHANGE 

PAPER HEADING I , 

LINE L_ 



APOSTROPHE 

I 



NEW PAGE HEADING TEXT 



1 



Figure 2-1. Source Input Line Formats 
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Statements : The PRIME 200 assembler accepts four types of 
statements: symbolic instructions, pseudo -operations , macro 
calls and commands to the RDALN source file update program. 
Each of these has a different sub-field format, and is 
described in a later section of this manual. 

If the line does not have a label, the first statement begins 
with column 2 or the first non-space character. Otherwise 
the statement begins with the first non-space character 
following the label. 

A statement is terminated by two spaces or column 73, 
whichever comes first. Subsequent characters are assumed 
to be comments and are ignored except for listing. 

Multiple Statements per Line : Statements can be packed two 
or more per line, separated by colons (:). The first 
non-space character following the colon is processed as 
the first character of the next statement. The last 
statement in the line is terminated by two spaces or column 73, 
and the rest of the line treated as comments. 

If the line begins with a label, the label is attached to 
the first statement during assembly. 

Continued Statements : The last statement in a line may be 
interrupted by a semicolon (;) and continued on the next line. 
The rest of the line following the semicolon is treated as 
comments. Processing of the statement continues with the 
first non-space character in the following line. Semicolons 
occurring within comments are not interpreted as a continuation 
request . 

Comments : All text following column 72, or following a 
statement and two or more spaces, is treated as comments, 
and ignored except for listing. Comments can contain all 
printing ASCII characters. 

Comment Lines : If column 1 of a line contains an asterisk 
(*) the rest of the line is treated as comments. (Comment 
lines can be used to continue comments begun in the preceding 
statement line.) 

Change Page Heading Lines : A line that contains an apostrophe 
( ' ) in column 1 is assumed to contain the text of all 
subsequent page titles. 
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Examples : The following assembly listing illustrates many 
of the free-form input features. 



01 

SI; 



0:1. 


■"'54 


01 


',".' Kj zz 


0.1 


":56 


01 


?57 


0:1 


~'6'0 


0:1. 


?e± 


0:1 


"'6.2 


01 


"■'€■3 


01 


~*64 


0:1 


-/1 6 5 


01, 


?.<"■€• 


01 , 


?67 


0:1 ; 


570 



■:: 0:197'.:' + TEST OF LONG LABELS. 

62. 01215 C0198':- flBCT:'EFGHLJ*KLriNi:iPQRSTIJVWXVZ0123456789 LDA ALPA 
02 01252 ■: 0199 > LDA ABCDEFGH I J*KLI v iNOPQRSTUVW;«: , r'Z012l:4.Sfi77ftCi 

<0200> : +: 

■:' 0201 ':> +:■■- TE 

V0202': 1 RB.. 

•:'0207> C f\, 

06. 1 2 :'i 5 •: 2 4 > D D ALPA. 

90000:1 (0205) x 

01. 01 21 5 ('0206::' RB J' HP A LP A 



OF FREE FORMAT AND LINE CONTINUATION 



I RX 

10 

ROD 
LLL 



BETA. 1 

9 COMMENT' 



14011..;| C0207> 
041166 C0208':' Li... 
26 01220 C0209> 
041067 (021O> 

C 021.1 :< + 
C0212':' +--•--■ 
02 00001 C 021.7 > ABX 

06 00002 
04 8000.7 

1 4 Pi ,:1 . .; 2 1 4 ::• R A : I A B : C R A : S T A 

000201 

140040 



COMMENT 



TEST OF MULTIPLE INSTRUCTIONS PER LINE. 
LDA 1 ■ ADD 2 : ST'A 3 
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CONSTANTS, VARIABLES AND EXPRESSIONS 

Constants 

Symbolic names and address expressions used within the 
assembler program statements may contain decimal, octal, 
hexadecimal or ASCII constants. 

Magnitudes : Numerical constants used in expressions are 
limited to the magnitudes that can be represented by the 
single-precision (16-bit) PRIME 200 binary arithmetic word: 

Type Max. Negative Max. Positive 

Decimal -32768 +32767 

Octal -'100000 +'777777 

Hexadecimal -$4000 +$7FFF 

Leading zeroes can be omitted. If the sign is omitted, the 
quantity is assumed to be positive. 

Double precision and floating point constants may be set 
up using the data defining pseudo-operations described in 
Section 4. However, these constants cannot be used within 
expressions . 

Decimal Constants : All numerical quantities are assumed to 
be decimal (base 10) unless they are tagged with the octal, 
hexadecimal or ASCII designator symbols shown below. 

Octal Constants : Octal constants (base 8) are identified 
by an apostrophe or designator: 

•123 or 0'123' or 0'123 

'+123 or 0'+123' or 0'+123 

'-123 or 0-123' or 0'-123 

Note that the sign follows the octal designator. In 
expressions, however, the minus operator must precede the 
designator: SYMBOL- '123 is legal, but SYMBOL+'-123 is not. 

Hexadecimal Constants : Hexadecimal constants (base 16) are 
identified by a dollar sign or X designation: 

$30BF or X'30BF' 
$-30BF or X'-30BF» 
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Here also the sign follows the designator, but in expressions 
the minus operator must precede the designator: SYMBOL-$30BF 
is legal, but SYMBOL+$ -30BF is not. 

The hexadecimal digit values are: 

Hexadecimal Digit Decimal Value 



0-9 


0-9 


A 


10 


B 


11 


C 


12 


D 


13 


E 


14 


F 


15 



ASCII Constants : One or two eight-bit ASCII character 
codes can be represented by the following notation: 

C'A' Represents the ASCII code for the 

character A, lef t- iustif ied in a 16-bit 
field with a trailing space character. 

C'AZ' Represents the codes for the ASCII 

characters A and Z, packed into a 16-bit 
field with A left justified and Z 
occupying the rightmost 8 bits. 

Any printing character of the ASCII character set can be 
used . 

Examples : 



h 'hi: 



in • 140£4i :: . '. h£i@4 .:■ P2:l : 6 DfiTft C" ft" 

'I 14 1-3 ? J;-'"- i: 6605 ':■ DAT ft C" ft 3 
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Variables 

Variables are alphanumeric strings, often called "symbols" 
or "symbolic names", that are equated to numerical values 
in various ways. If a variable is used as the label of a 
statement, it is assigned the value of the location count 
for that statement. Variables may also be defined by the 
SET, EQU and DAC pseudo-operations described in Section 4. 

Variables can be from 1 to 32 characters long. The first 
character must be a letter (A-Z) , and the remaining characters 
may be letters, numerals (0-9) or the dollar sign ($) . 
Variables containing more than 32 characters m 

are allowed but only the first 32 characters are recognized 
by the assembler. Variable names must be unique (cannot be 
defined more than once) . 

Examples : The following examples show some of the ways a 
variable "VARI35$" can be used. 



8;? OS 2 
82 003 

82884- 



02. 812: 

02. 813:'.' 

881 2" 

81 812" 



08 Mb 

8887 

8888 

C8889 



P2*7 


L..DH 


VARI35* 




LDR 


VflRI35*+ 


VRRI35* 


SET 


-' 1234 




JMP 


VARI35*- 



2-7 



Expressions 

Expressions consist of constants or variables joined by 
operators. All variables within an expression must be 
defined as single precision values or addresses. Absolute, 
relative and external values cannot be used in the same 
expression. 



Examples : 

Fr-Fiii'V I - iv-i.\\n< ■■ .0010 .' P2:$:J i.OFl k 1.00+.;. 

ft"'!"! Of" 



,. fj-j;,.!,:- .:08ii.:.. STfl + + VRRI35*-K100 



Operators : The PRIME 200 assembler is able to process the 
following arithmetic, logical, relational and shift operators 
while evaluating expressions in instruction address fields, 
arguments in macro calls, etc. 

* Arithmetic Multiply 

/ Arithmetic Divide 

+ Arithmetic Add 

Arithmetic Subtract 

.OR. Logical OR (16 bits) 

.XOR. Logical XOR (16 bits) 

.AND. Logical AND (16 bits) 

.EQ. Relational EQ (resulting in or 1) 

.NE. Relational NE (resulting in or 1) 

.GT. Relational GT (resulting in or 1) 

.LT. Relational LT 

.GE. Relational GE (resulting in or 1) 

.LE. Relational LE (resulting in or 1) 

.RS. Logical Right Shift (16 bits) 

.LS. Logical Left Shift (16 bits) 
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Space Conventions : Operators may be followed by a single 
space (optional.). The logical, relational and shift operators 
must be preceded with a space so that the period beginning 
these symbols will not be interpreted as a decimal point. 



Operator Priority : In expressions with more than one operator, 
the order of evaluation is governed by operator priority. 
The operator with the highest priority is performed first. 
In cases of equal priority, the evaluation proceeds from 
left to right. Parentheses may be used to alter the natural 
order of evaluation. 



Priority 
Highest 



Lowest 



Operator (s) 



* / 
+ - 

.RS. 

.GT. 

.AND. 

.OR. 

.XOR. 



LS, 
GE. 



EQ, 



NE 



.LE. .LT. 



Relational Operators : These are most often used in the 
argument field of IT pseudo-operations. However they may 
be used in other expressions. Examples of the correct 
syntax are: 



>'■ K.I.. 



01304 • 


000001 


■ ;-V :■"> L 


01 305 


000000 




01306 


0001-11 ill 




01307' 


000000 


■■ tl_36 '■' 


0:1 310 


000001 




01 311 


000001 




01 3:1.2 


0000R0 


< 0237' •' 


01313 


000000 




0131.4 


000001 




0:1 3:15 


000000 


•:'0238':' 


B 13 IS 


000001 




0:1 317 


000000 




01 320 


000001 


•::023:-l:' 


01321 


000000 




01 322 


000001 




01323 


000001. 


OI1240> 


01324 


0Q0l" : i01 




0:1 325 


000000 





TEST RELATIONAL OPERATORS 
DATA : 



DATA 



DATA 



DATA 



EQ. 5, 5 . EQ S. 6 . EW. 



NE 



A 



LT. 



DATA 5 GE. 



DATA 5 LE 



cr cr 



NE S.. 6 NE 



T 5.. 5 . GT 6.. €• . GT 



cr cr 



LT. &, 6 LT. 



HE. 6.. G . GE. 



LE 6, 6 . LE. 5 
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Shift Operators : The shift operators perform a logical 
right or left shift of an expression, using the syntax: 



Argument 
Expression 



LS 
RS, 



Shift Count Expression 



where the shift count expression has a numerical value from 
1 to 16. 

Examples : 









'■■: 0241) 


:+ 








'• 0242 > 


i- 


©1" 


'■'2.S 


000101 


v024~O 




01" 


• *::'.. i'' 


010100 






0i : : 


30 


020200 






si :• 


31 


010100 


(02:44 > 




01." 


'•-•'•'"" 


000101 


(0245> 


■■+■■ 



■TEST SHIFT OPERATOR. 
DRTfl ■- 1010 . RS. S, ■- 1010 . L. 



DRTfl -' 1010 . RS. --J, - 1010 



1010 L. 
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Logical Operators : Examples are shown below. 







' 


0229 '■' *■■ 


— 1 


Gi- 


1301 


901.101 ' 


'0230> 


['.: 


ft' 


1302 


001.001 ' 


.0231. ■• 


C 


0- 


i ;-;,;",-:;; 


000:1 l"iP ' 


'0232> 
'0233> : + : 


[: 



EST LOGICAL 
jflTR •■' 11.00 
jflTR -' 11.00 
T0 "' 1.1.00 



E ROTORS 
-' 0-101. 
iR " 8101. 



Rt-iO 



010:: 
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Sign Conventions : In expressions containing the + and 
operators, integer constants ^ay be signed: 

2 7 ■ 62. 9 1 7 :'l 5 (00:1 3 !:■ P 2 i" 1. 2 

02010' 02. i 7 '! !' : i >:" 1 4 > 

2 m 1. "I.. ' 2 . 1 7 ':■'< 5 < 861 5 > 

2 Pi 1. 2 : 02 01.7' 7, 7 < 9 i 6 "> 

2 ::l . 2 G 7 ■,' 1 7 > Z 1 L C H 

02014 0001 4 7 (00i3> RLPHR DRIP 



LDfl 


2ILCH-*2E 


LDP 


ZILCH+*-3E 


L.DR 


RLPHR--' 37 


L.DR 


RLPHR-i-- -37 


DEC 
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SECTION 3 
INSTRUCTION STATEMENTS 



This section defines the form of all PRIME 200 instruction 
statements, shows how instructions are processed by the 
assembler and loader, and covers syntax elements peculiar 
to instruction statements. 

Table 3-1 lists the instruction mnemonics acceptable to the 
assembler. Note that some instructions have two mnemonics; 
those in parentheses are accepted for compatibility with 
other assemblers. Mnemonics in Table 3-1 are in order by 
functional type. The instructions are sorted by op-code 
in Appendix A, by class in Appendix B, and by mnemonic in 
Appendix C. 

INSTRUCTION STATEMENT GENERAL FORMAT 

The essential elements of an instruction statement are an 
operation field and a variable field, separated by spaces, 
a comma, or a backslash tab symbol (\) , as shown in 
Figure 3-1. The content of each field depends on the type 
of instruction being processed. Memory reference instructions 
have different requirements than I/O, shift, bit reference, 
or generic instructions. Label and comment fields are 
optional , 

Label 

rf a label is present, it is assigned the current location 
count and entered in the symbol table. 

Operation Field 

The operation field must contain one of the PRIME 200 
instruction mnemonics listed in Table 3-1. An asterisk, 
for indirect addressing, applies to memory reference 
instructions only. Parentheses are ignored: 

03 24?- 82. 8601;? >::018±::' •:!LDR> 18 

pi-| P4~: ■ 42 0081? 03182'.:' a.DR+> If 

01244' 42.000:3? '-81S3:> CLDFO* 18 

fn?4?=;- £2 0001? '•8184::' CLDFO* 10' 1 
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Table 3-1. Summary of PRIME 200 
Instruction Codes 



CI ASS OP CODE MNEMONIC DEFINITION 



140040 


ORfi 


1408:14 


CRB 


140010 


CRI. 


0?' 


I....DA 


04 


•=, rfl 


15 


i. dx 


15 


STX 


11: 


I. MR 


000201 


IflB 


J >1 0.1.04 


XOA 


140204 


XCB 


000111 


CFR 



LOAD 


INDEX 


< ASSEMBLER SET' 


-; inde:>: 


BIT' 


STORE 


INDEX 


■: ASSEMBLER CLEARS 


INDEX E 


INTER 


CHRNGE 


MEMORY AND R 








INTERCHANGE 


A AND B 








TRANS 


FER R 


TO B AND CLEAR 


A 






TRAN'E 


FER B 


TO A AND CLEAR 


B 






COMPUTE EFFECTIVE RDDPESS 









REGISTER OPERATE 

|-. ; 140040 CRR CLEAR A 

G 140014 CRB CLEAR B 

G 14O010 CRI. CLEAR LONG <fi AND B 

MR 02 IDA LOAD A 

MR 04 STA STORE R 

MR 

Hf,: 15 SIX STORE INDEX ■: ASSEMBLER CLEARS INDEX BIT: 

MR 

G 

i"; 

G 

G 

ARITHMETIC 

RDD MEMORV TO R 

SUBTRACT MEMORV FROM A 
CAIA) ADD ONE TO A 

ADD TWO TO A 
•:S1A::- SUBTRACT ONE FROM A 

SUBTRACT TWO FROM A 

ADD C-BIT TO A 

COPV SIGN TO C-BIT, SET SIGN OF A PLUS 

SET SIGN OF A PLUS 

SET SIGN OF A MINUS 

CHANGE SIGN OF A 

TWO'S COMPLEMENT A 

POSITION FOR INTEGER MULT I PL V 

POSITION FOR INTEGER DIVIDE 

MULT I PL V 

DIVIDE 



MR 


66 


ADD 


MR 


07 


SUB 


G 


141206 


AOR 


Fi 


1403G4 


A2R 


G 


1 -4 0110 


SO A 


G 


149310 


S2R 


i"i 


141216 


AC A 


i.i 


1.40320 


CSR 


G 


1.40100 


SSP 


G 


148500 


SSM 


G 


140024 


CHS 


G 


1.40407 


TCA 


fi 


0002O5 


P I M 


G 


000211 


P I D 


Ml'.: 


16 


MPV 


MR 


17 


D I V 
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Table 3-1 (Cont) 



MR 


02 


+ 


DI..D 


MR 


0'-1 


+ 


DST 


MR 


ee" 


••+• 


DAD 


MR 


07 


+ 


DSB 



DOUBLE PRECISION 
DOUBLE PRECISION 
DOUBLE PRECISION 
DOUBLE PRECISION 



LORD 
STORE 
ADD 
SUBTRACT 



INPUT/OUTPUT 



TO 
10 
1 
1 

G 
G 
1 



G 
G 
G 

G 

G 
G 
G 
G 
G 
G 
G 
G 
G 
G 



1.4 
24 

54 
74 

000511 

000515 
7 A 



0000WW 
0001301 
140600 

140200 

000005 
000007 
000503 
000501 
000021 
000011 
000013 
001013 

000505 

00031 1'+"+ : 



OCP 
SKS 
I Nfl 
OTfl 
ISI 
OS I 
SMK 

CONTROL 

HIT 
NOP 
SCB 
RGB 

SOL 

DBL 

EMCM 

LMCM 

RMC < RMP > 

EUSSCDXA':- 

E32S<EXf\> 

E32R 

VIRV 



OUTPUT CONTROL PULSE 

SKIP IF SET 

INPUT TO R 

OUTPUT FROM R 

INPUT SERIAL INTERFACE TO A 

OUTPUT SERIAL INTERFACE FROM 

SET INTERRUPT MASK 



A 



HALT 

NO OPERATION 

SET C 

RESET 

ENTER 
ENTER 
ENTER 
LEAVE 



RESET 
ENTER 
ENTER 
ENTER 32K 
SUPERVISOR 
VERIFV 



B I T 

C-BIT 

SINGLE PRECISION MODE 

DOUBLE PRECISION MODE 

MACHINE CHECK MODE 

MACHINE CHECK MODE 

MACHINE CHECK 

1SK SECTOR ADDRESSING 

32K SECTOR ADDRESSING 



MODE 
MODE 



RELATIVE 
CALL 



ADDRESSING MODE 
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Table 3-1 (Cont) 







LOGICRL. 




MR 


03 


flNfl 


AND TO A 


MR 


85 


ERG 


EXCLUSIVE OR TO R 


G 


140401 


OMA 


COMPLEMENT fl 


G 


149413 


LEO 


CONVERT R=0 TO TRUE 


G 


146412 


1. MF 


CONVERT - '::R=0::' TO TRUE 


G 


1*19411 


L I .. E 


CONVERT ROO TO TRUE 


G 


148414 


1... GE 


CONVERT fl>=0 TO TRUE 


G 


:1. 40419 


LIT 


CONVERT fl<0 TO TRUE 


G 


140415 


LOT 


CONVERT R>0 TO TRUE 







INTERRUPT 


r-i 


098401 


ENB 


G 


801001 


I NH 


n 


000415 


FSIM 


G 


800417 


FVIM 


i. i 


008411 


CRI 


G 


000042' 


I NK 


G 


888405 


OTK 



ENABLE INTERRUPT 

INHIBIT INTERRUPT 

ENTER STRNDflRD INTERRUPT MODE 

ENTER VECTORED INTERRUPT MODE 

CLEAR ACTIVE INTERRUPT 

TRANSFER < INPUT;- STATUS KEVS TO A 

TRANSFER (. OUTPUT > A TO STATUS KEV:! 



SHIFT 



SH 


8414NN 


ALL 


<LGL> R LEFT LOGICAL 


SH 


8404NN 


ARL 


<:lgr> a right logical 


SH 


8416NN 


AI..R 


A LEFT ROTATE 


SH 


8406NN 


RRR 


A RIGHT ROTATE 


SH 


8415NN 


Rl_ S 


A LEFT SHIFT 


SH 


8485NN 


RRS 


A RIGHT SHIFT 


SH 


8410NN 


LI J. 


LONG LEFT LOGICAL 


SH 


8488NN 


LRL 


LONG RIGHT LOGICA 


SH 


8412NN 


LI.R 


LONG LEFT ROTATE 


SH 


8482NN 


L RR 


LONG RIGHT ROTATE 


SH 


8411NN 


I 1 S 


LONG LEFT SHIFT 
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Table 3-1 (Cont) 



■-;h 


04 01NN 


I...RS 


G 


000101 


NRM 


G 


000041 


SCA 



LONG RIGHT SHIFT 

NORMALIZE 

TRANSFER SHIFT COUNTER TO fl 



BVTE MANIPULATION 



G 


141340 


I Cfl 




inter 


CHANGE BYTES OF A 


G 


141140 


ICL 




inter 


CHANGE BYTES OF A AND CLEAR LEF1 


G 


141240 


ICR 




inter 


CHANGE BYTES OF A AND CLEAR RIQh 


G 


1.41050 


CAL 




CLEAR 


LEFT BVTE OF A 


G 


141044 


CAR 




CLEAR 


RIGHT BVTE OF A 




0:1. 


TRANS 


;fer 


AND SK 


IP 




MR 


..IMP 




UNCONDITIONAL JUMP 


MR 


10 


J ST 




.JUMP 


TO 


ER.+ 1 AND STORE "P IN EA 


G 


100000 


SKP 




UNCONDITIONAL SKIP 


MR 


12 


IRS 




INCREMENT, REPLACE MEMORV AND SKIP 


G 


1.40114 


I RX 




INCREMENT.. REPLACE INDEX AND SKIP 


G 


1.40210 


DRX 




DECREMENT REPLACE INDEX AND SKIP 


MR 


1.1 


CAS 




COMPARE 


A WITH MEMORV 


G 


140214 


CAZ 




COMPARE 


A WITH ZERO 


i"; 


100400 


SPL <: 


: sge :: 


• SKIP 


ON 


A PLUS 


f./i 


1.01400 


SM I < 


•slt; 


■ SKIP 


ON 


A MINUS 


G 


1GG040 


SZF < 


:seq:: 


■ SKIP 


ON 


A ZERO 


G 


1.01040 


SNZ •: 


: sne ; 


> SKIP 


ON 


A NOT ZERO 


G 


100220 


SGT 




SKIP 


ON 


A GREATER THAN ZERO 


G 


101220 


SLE 




SKIP 


ON 


A LESS THAN OR EQUAL TO ZERO 


G 


1.00100 


SLZ 




SK I P 


ON 


A BIT 16 ZERO 


G 


1.01100 


SLN 




SKIP 


ON 


A BIT 16 ONE 


BR 


1 01260+ N 


SASN 




SK I P 


ON 


A BIT N SET 


BR 


1 00260+ N 


SARN 




SK I P 


ON 


A BIT N RESET 





1.01001 


ssc 




SKIP 


ON 


C-BIT SET 


G 


100001 


SRC 




SKIP 


ON 


C-BIT RESET 


G 


101200 


SMC Si 


;:sps: 


:■ SKIP 


ON 


MACHINE CHECK SET 


G 


100200 


SMOR' 


::spn: 


> SKIP 


ON 


MACHINE CHECK RESET 
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Table 3-1 (Cont) 



181836 SSS 

G 188836 SSR 

BR 181248+N SSN 

BR 188248+N SRN 



SKIP ON ANY OF SENSE SWITCHES 1-4 SET 
SKIP ON NONE OF SENSE SWITCHES 1-4 SET 
SKIP ON SENSE SWITCH N SET 
SKIP ON SENSE SWITCH N RESET 



NOTES 

DOUBLE PRECISION MODE MUST BE IN EFFECT CSEE DBL, SQL> 
** EXECUTED BV TRAP TO SUBROUTINE 
■:: > = ALTERNATE MNEMONIC FOR COMPATIBILITY WITH OTHER ASSEMBLER: 

CLASS CODES: 

BR - BIT REFERENCE 

Q - GENERIC 

10 - INPUT / OUTPUT 

MR - MEMORY REFERENCE 

SH - SHIFT 
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Variable Field 

All except the generic instructions require an entry in the 
variable field that can be evaluated as a 16-bit single- 
precision quantity. The types of expression that can be 
used are summarized in Figure 3-1. If the expression is 
followed by ",1" (memory reference instructions only) the 
index bit is set. 

For memory reference instructions, the variable field, 
indirect address bit, and indexing bit, interact to form the 
instruction's effective address. 

Input/Output instructions interpret the variable field as 
the device code and function code of an I/O device 
controller. 

For shift instructions, the variable field specifies the 
number of bit positions the A and B registers are to be 
shifted. 

For bit reference instructions, the variable field specifies 
the panel sense switch (1-16) to be tested. 

Generic instructions ignore the variable field. 

Asterisk (Current Location) : An asterisk in the variable 
field represents the current value of the assembler location 
counter. The asterisk is used in address expressions that 
describe a displacement from the current location: 

COUNT IRS ALPHA 
JMP * - 1 



JMP COUNT 

Both JMP instructions point to the same location, but the 
one using the asterisk does so without using a symbolic 
name. 



Double Asterisk (Initially Zero) : A double asterisk in 
the variable field causes the assembler to load zeroes in 
the 9-bit address field and the sector bit. (Indexing and 
indirect addressing are normal.) This convention is used 
when the desired location is to be developed or modified by 
other instructions or is not known at the time of assembly. 
For example: 
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BACKSLASH (TAB). 
SPACES OR COMMA 



\ 



LABEL 



OPERATION FIELD 



VARIABLE FIELD 



OPTIONAL 
(FIRST STATEMENT 
IN A LINE ONLY) 



r 




NOTE I 



^\ 




MNEMONIC 



EXPRESSION 



/ 



ASTERISK SPECIFIES 
INDIRECT ADDRESSING 
(NOTE 2) 



NOTES 

1. IF MORE THAN 10 SPACES 
FOLLOW THE OPERATION 
FIELD, THE ASSEMBLER 
ASSUMES THERE IS NO 
VARIABLE FIELD AND 
TREATS THE REST OF 
THE LINE AS COMMENTS. 

2. OPTIONAL. APPLIES 
MEMORY REFERENCE 
INSTRUCTIONS ONLY. 




EXAMPLE 

ALPHA 

SENDSTYP.CHAR 

ALPHA+3 

EXAMPLE+2-l+ALPHA 
EXAMPLE. LS. 5 

= 49 
= •37 

= $AF 
=AXY 

* + 3 

♦ -•77 

*+ ALPHA 
** 



/ 



,1 SPECIFIES 
INDEXING 
(NOTE 2) 



CONSTANTS 



SYMBOLIC NAMES: 
} VARIABLES OR 
ENTRY POINTS 



EXPRESSIONS 



> LITERALS 



RELATIVE TO 
CURRENT LOCATION 

\ TO BE ASSIGNED 
/ LATER 



Figure 3-1. General Format of Instruction Statements 
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Equals Sign (Literals) : A literal is a constant preceded 
by an equals sign, as in: 

02023 ' 02.0201:2 <0025> F3*9 LDfl -"' 108 C OCTAL',' 

The assembler associates the numerical value of each literal 
with the symbol used ('100 in this case) and reserves a 
storage location for a constant of that value. Any later 
reference to a literal of the same value addresses the same 
reserved location, even if a different constant format is 
used: 
3?fi?4- P.2 M2|- : R2 .:;0026> LDFl =*4«3 ..'HEXADECIMAL 
02025: 62. 02822 <0S27> LDfl =64 '.DEuIMl-li J 



Literals are self -defining . The name of the literal 
identifies the values of the constant to anyone reading the 
listing, whereas names assigned to constant locations by 
SET or similar pseudo-operations are meaningful only to 
the original programmer: 

K100 SET '100 

LDA K100+3 

Actual locations containing literals are not assigned until 
the assembler reaches a FIN or END pseudo-operation. All 
literals assigned up to that point are then assigned 
sequential locations. On the final assembly pass, the 
address fields of statements that reference the literals 
are filled with the appropriate locations: 

<@019> *-- TEST OF LITERALS AND FIN PSEUDO-OP 



02000: 02 02001: ':'0020> 

02001 : 06 02084 OH 021'.:' 

02002: 04.02005 <8022> 

02003 000144 •:'. 002"l: > 

02004 : 000100 

02005 : 000400 

02006: 02.02003 C0024> 

02007: 06.02064 <8825> 

02010: O4.02005 ■'0©26> 

C 0027 > 

02011: 02.02003 <@028> 

0201.2: 06 02054 <082SO 

020:13: 84 02055 C003:0> 



-TEST 


OF LITERAL. 


LDA 


= 1.00 


RDD 


= "' 100 


ST A 


= X-' 100" 


F I N 





LDA 


= 100 


ADD 


=•- 108 


STfl 


=:«;■" loo- 


FIN 




I...DR 


=188 


ADD 


= 101 


ST A 


=;:•:;■•• 102 



DUMP LITERALS HERE 



GENERATE NEW LITERfl. 



002854 <!0070> END 



02054 : 0001.45 
02855 : 000482 
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ASCII Literals : Literals can be set to equal the binary 
codes of one or two ASCII characters. The form = C'X' loads 
a character (X, for example) into the left-hand byte 
(bits 1-8), and loads a space character into bits 9-16: 

02026' 62. 02033 Oj028> LDR =C X' ASCII DIGIT X* PACKED LEFT 

The form =AXY is loaded as two characters (X and Y, for 
example), with X in the left-hand byte (bits 1-8) and Y in 
the right-hand byte (bits 9-16) : 

2 Pi 3 ? h 2 2 3 4 •:. O 2 3 "■' L DA - C "' X V ■" ASCII DIGITS XV 

(For ASCII character codes see Appendix E.) 



02031 : 154240 
02634 : 15433 1 
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MEMORY REFERENCE INSTRUCTIONS 



Memory reference instructions are assembled as 
Figure 3-2 and the following listing examples. 



shown in 









'■0155::' 


+-■■- - 


-MEMOR 


t 1 REFERENCING 


INSTRUCT I 


0121.5 


01 


00100 


■:: 01.56 '.:■ 


RLPR 


JI-IP 


•" 100 




01216 


02 


012:15 


1 01.57) 




LDR 


RLPR 




01217 


4 3 


01215 


'.. 015:3 ) 




RNR+ 


RLPR 




01. 220 


24 


01215 


■:'0159> 


BETA 


STR 


RLPR, 1 




01221 


63 


01.21 5 


(!0160> 




ERR* 


RLPR.- 1 




01222 


06 


01215 


<: 0161 s .' 




RDD 


RLPR 




01223 


07 


01.220 


C0162) 




SUB 


BETR 




01224 


10 


01224 


•:: 0:163 s ' 




•J ST 


# 




01225 


12 


01220 


■:: 0164 > 




IRS 


BETR 




01226 


00 


01220 


<0165) 




PZE 


BETR 




01.227 


00 


O1220 


>'. 01.66) 




+ ■+:+: 


BETR 




0:1230 


11 


01230 


OH167) 


GRMR 


CRS 


GRMfi 




0123:1 


13 


01230 


':'0:168) 




I MR 


GRMR 




01232 


16 


00050 


•::0169) 




MPV 


40 




01233 


17 


0:1220 


•::0170) 




DIV 


BETA 




0:1 234 


15 


01220 


<0171> 




STX 


BETA 




01235 


35 


01.226 


< 0172 ) 




LDX 


BETR 




01236 


02 


01.220 


■:: 0:173) 




DI....D 


BETR 




01237 


64 


01220 


•:'.0174) 




DST 


BETA 




0:1 240 


06 


01220 


(! ©1.75) 




DRD 


BETR 




01241 


67 


00000 


< 01.76) 




DSB+ 


0, 1 





DN!: 
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SOURCE STATEMENT 



ERA* 



ALPA,1 



OCTAL PART 
OF ASSEMBLY 
LISTING 



INSTRUCTION 
WORD FORMED 
BY LOADER 



il 



c 



_X x ^ 



I I 0„l I. ALPA= I2IS 



i r 



01221: 65* 01215 <0160> 



ASSUMES LOAD MODE 
IS ABS. ALPA IS IN 
SAME SECTOR AS 
INSTRUCT ON 



I I 
I I 



I I 
__J L__ 



I 



I 



I X 



OP 



^s^- 



ADDR 



16 



I I 



Figure 3-2. Assembly and Loading of 
Memory Reference Instruction 
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Operation Field 

Mnemonic: The operation field must include one of the PRIME 200 
memory reference instruction mnemonics shown above and 
listed in Table 3-1. 

Asterisk (Indirect Addressing) : An asterisk following the 
mnemonic specifies that the instruction word's indirect 
address bit is to be set. 

Triple Asterisk (Dummy Instruction) : A triple asterisk in 
place of an instruction mnemonic is a pseudo-operation 
code that causes the assembler to form a memory reference 
instruction with an op-code of zero. Another asterisk may 
be added to specify indirect addressing. The variable field 
of such a statement is treated like any other memory 
reference instruction: 











•::01.S 


5) 


+ 












<01S 


t> '■'' 


+ — 


-- v'HCRNT OPERi 


-IT OF 


0:1 


3 4 ft 


G0 


000:1;"' 


>' 0i£ 


..., . :i 




■■*■■•*■■■+■■+■■ 10 




0:1 


;-:4?' 


00 


000:1. ;■'■• 


ceis 


o .■' 




+ ■+■:+; 1.0 




01 


"'50 


SQ 


0001 : ;:: : 


C01S 


9 ) 




+ '+ 10 




01 


"■5:1 


00 


000:1 ;"' 


v 01.90; 1 




■■*■ 10 












':'01.:~ 


1> 


:+ : 







Variable Field 

The variable field of a memory reference instruction contains 
an address expression (symbolic address) and an optional 
indexing symbol (,1). 

Symbolic Addresses : Addresses are specified by any constant, 
variable, literal, or expression that can be evaluated as 
a single-precision 16-bit number. The sign (bit 1) is 
disregarded, and the magnitude bits (2-16) are interpreted 
as a memory location in the range from to 32,767. 

Addresses may be processed further by the loader if 
relocatable load mode is specified by the REL pseudo- 
operation. After loading, the way the CPU interprets the 
address depends on the addressing mode, controlled by E16S, 
E32S, and E32R instructions. 
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Indexing (,1) : Indexing is specified by a ",1" following the 
address expression (optional). The form ",0" is interpreted 
as non- indexing . Therefore the 1 or can be replaced by 
an expression using relational operators that returns a 
value of or 1. For example in the statement 

02f : i:"::0 ■ 22.02014 < 0020. > E/ AMPLE LDfl ALPHA. TEST EQ. 5 
00000? <002i'- 1 TEST SET 5 

indexing results because the variable TEST equals 5 at the 
time of assembly. This feature would be useful mainly tor 
conditional assembly operations. 

For the LDX command, the assembler set the index bit, and 
for STX, the assembler clears the index bit. Indexing 
cannot be specified in these instructions. 



INPUT/OUTPUT INSTRUCTIONS 

Input/Output instructions are assembled in the form shown 
in Figure 3-3. Label and comment processing is normal. 

Input/Output instructions are identified by a 6-bit operation 
code that occupies the indirect bit and indexing bit positions 
Therefore, indexing and indirect addressing are not permitted. 

The variable field must contain a four-bit function code 
concatenated with six-bit device address code. The resulting 
10-bit code is usually specified in octal notation, as in 
Appendix D, but any kind of constant, variable, or expression 
is acceptable if it can be converted into a meaningful 
10-bit code. 

Examples : 







<0140.'.i +- 


I/O 


INSTRUCTION 


0:1204 ■ 


0301.00 


C 014:1.::' 


OOP 


"' 100 


01205 : 


070:1.01 


'.:0142:' 


SKS 


' 101 


0:1 206 : 


1.70102 


<014:;:> 


SMK 


•' 102 


0:1207 : 


130106' 


■:: 0:144.'.' 


I NR 


-' 106 


01210 : 


i.70j 2:? 


•:'0145:> 


OTA 


' 123 



0146;' ■#■ 
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SOURCE STATEMENT 



OlA 



123 



X 



i i 



OCTAL PART 
OF ASSEMBLY 
LISTING 



INSTRUCTION 
WORD FORMED 
BY LOADER 



Lf 



01210: 170123 CW145) 



1 



\r ^ f \ 

i oooooi OIOOI I 



'l 






16 ^ 


1 


i i i 




I 1 


1 
■ 1 




• 


1 

i 


1 

i — 


1 


u 




FUNCTION.. 
CODE 




DE\ 


(ICE 
*ESS 


— 


r 


— \Jf \AJUC 






ADDI 



Figure 3-3. Assembly and Loading of 
Input/Output Instruction 
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SHIFT INSTRUCTIONS 

Shift instructions are assembled in the form shown in 
Figure 3-4. Label and comment processing is normal. 

Shift instructions are identified by a 10-bit operation code 
that occupies the indirect bit and indexing bit positions. 
Therefore, indexing and indirect addressing are not permitted. 

The variable field must contain an expression that can be 
evaluated as a positive number representing the number 
of shifts to be executed. (The assembler forms the 2's 
complement of the quantity before setting it into bit 
position 11-16 of the instruction word supplied to the loader.) 
Any variables in the expression must be defined numerically 
by EQU or SET pseudo-operations (Section 4) . 

Examples : 



•;ei24> ■*■ 



— SH I FT I NSTRUCT I QMS 



0:1 1.66 


041400 


'■: 0:1.25 :> 


ENTR LQL 





011.67 


041408 


OIH26"' 


FILL 





01 1.70 


040577' 


< 01.27':' 


flRS 


1 


0117:1. 


040676 


■:'0128> 


RPR 


c:' 


01:1.7;": 


040475 


■• 8129> 


I...GR 


™" 


01 1.73 


040-175 


i '0130!:' 


flRL 


"■ 


01 1 74 


041574 


<0131> 


flLS 


4 


01:1 75 


041.673 


<@1S3> 


flLR 


5 


0:1 1 76 


04007;-:' 


>:'0133::' 


LRL 


6 


011.77 


0401 71 


03134]:' 


LRS 


(' 


01 ,'"'00 


040278 


•::0135> 


LRR 


o 


01 201 


041067 


•:!0136:: 1 


LLL 


ci 


01 202 


0411.66 


•::0137> 


LLS 


10 


01203' 


041265 


<0138> 


I...LR 


11 
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SOURCE STATEMENT 



OCTAL PART 
OF ASSEMBLY 
LISTING 



INSTRUCTION 
WORD FORMED 
BY LOADER 



LRR 



2. 
COMPLEMENT 



If 



018001 040270 (0135) 



16 






1 

1 










< 




1 


1 1 1 

1 1 



« » 












NO OF SHIFTS - 








ur IASL/C 








IN 2* 


iCOMPL \ 



Figure 3-4. Assembly and Loading of 
Shift Instructions 
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BIT REFERENCE INSTRUCTIONS 

Bit reference instructions test the condition of the panel 
sense switches; they are assembled as shown in Figure 3-5. 
Label and comment processing is normal. 

Bit reference instructions are identified by a 12-bit 
operation code that occupies the indirect and indexing bit 
positions. Therefore these operations are not permitted. 

The variable field must contain an expression that can be 
evaluated as a positive number between 1 and 16 decimal. 
The number becomes the code that selects the sense switch 
to be tested. Any variables in the expression must be 
defined numerically by EQU or SET pseudo-operations 
(Section 4) . 

Examples : 







r 


014 1 :? .:■ 


0:1211 ■ 


1G1.2< 


1-6 •: 


8148;.i 


01 212 : 


1002' : 


11 •: 


0149':' 


m 213 • 


10121 


'•*-, : 


0150 > 


0:1214 : 


1002'; 


., ..... ( , 


0151 > 



-BIT REFERENCE INSTRUCTIONS. 



5SK 


1 


3R! 


•"• 


5RS 


15 


5HP 


IE 
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SOURCE STATEMENT 




OCTAL PART 
OF ASSEMBLY 
LISTING 



INSTRUCTION 
WORD FORMED 
BY LOADER 



018141 100277 (0151) 



'l 








\ 

16 


1 



1 1 





1 
1 i 


1 1 1 


1 1 1 






f\p PftTJF 




SENSE 
-SWITCH— •■ 
CODE 













'00 = SWITCH I 

'i7=switch 16 



Figure 3-5. Assembly and Loading of 
Bit Reference Instructions 



3-19 



GENERIC INSTRUCTIONS 

Generic instructions (Figure 3-6) are fully defined by their 
operation codes and do not require operands, addresses, or 
other arguments in the variable field. The variable field 
must be null. Labels and comments are handled normally. 

Examples : 



INSTRUCTIONS 







'. 0015.:. 


*-— genef: 


81.0:0 : 


080000 


'■ 8816':' 


STRT HL.T 


0:1 0:1.4 ■ 


00001 i I 


■:' 881.7 > 


NOP 


0-1 015 


800005 


'■'001:' '■ 


SGL 


8.1 0:1 .i 1 :' : 


080887 


t. 681 3 > 


DEL 


81017 : 


8880:1 :!. 


O3028> 


DXR 


8:1 028 • 


00001 :i 


< 662:1. > 


E16S 


0:1.021 ' 


0800:1 3 


'• 8622> 


EKR 


010 "■•:;• 


8800:1 7 


•:'0823> 


E32S 


8:1 0:55 


888021 


<8826> 


EI1P 


81 026 


880021 


■:. 00r : '7> 


Rf-hJ 


8:1 027 : 


80084:1 


'■' 882 f- ■'■ 


SCR 


0:1 030 • 


808047 


•: 882' '■'.* "■> 


I NK 


0:1 071. ; 


0001.01. 


'■. 6038 ,' 


NRI'l 


1 :'•' ' 


8881.05 


'• 883:1.::' 


ef>=:m 


8:1. 07": ■ 


0881 87 


, :'8632':' 


LFrtH 


01 074 ■ 


8881:1 1 


'■86 3 7: 1 


CEfi 


81075 • 


8881:1 5 


■:' 0074 .:■ 


LJIM 


8:1 076 ; 


8881 1 7 


'::8635> 


EJIM 


01077 : 


8862:01 


, ::6636> 


IRE: 


8:1 048 : 


668205 


'■ 8637 :< 


P I M 


81 041 


0862:1 :1 


03838> 


P I D 


01.042 • 


88021 5 


■: 8039':' 


LPM..T 


81 043 : 


88821 7 


'■ 8646 :' 


EPMJ 


0:1 044 • 


8882' 1 7' 


•: 8841 :.> 


EVI'U 


0-1 04 "5 ' 


0003 1 1 


':'8842':' 


D I RG 


0:1 047 : 


888401 


'■. 8844 '■> 


ENE 


81050 ■ 


888405 


'':8845':' 


OTK 


8:1 851 : 


88884 1 


i:'6046':' 


CRT 


8:1 052 : 


8664:1 5 


'::8847::' 


ESI 11 


8:1 853 ■ 


88841 7 


•::@848'.'' 


EVIM 


8:1 05- 1 - : 


88850:1 


(8649:: 1 


LMCI'l 


81055 • 


868583 


■' 8858 ::■ 


EHCM 


81.056 : 


686505 


C 66513' 


SVC 


81 OS?' : 


8665:1:1 


•■': 8052 > 


1ST 


8.1 068 : 


888515 


<8853> 


OS I 


81061 : 


881881 


•■. 8854 > 


I NH 


81 862 : 


88181 1 


<!0@55> 


E64R 


81867 ■ 


8816:1 3 


C 8056 > 


E32R 
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SOURCE STATEMENT 



MCB 



OCTAL PART 
OF ASSEMBLY 
LISTING 



01 153 



140204 



(81 12) 



INSTRUCTION 
WORD FORMED 
BY LOADER 



', 


1 


1 



I 1 



1 1 


1 
■ 1 



1 1 


1 

1 1 












- wr wvl/u 




1 



Figure 3-6. Assembly and Loading of 
Generic Instructions 
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0:1.066 


001401 


'■ 0052 ' 


EPI-i 


01067 


100000 


<: 0060 ':> 


SKP 


0:1.070 


101400 


•:'0061 '.'' 


SLT 


01071 


1.01400 


C 0062 '•'' 


SMI 


01 07? 


100400 


■: 006" :• 


SGE 


0107": 


100400 


'." 0064 :> 


SPL 


01 074 


101.220 


'03065 ' 


SL.E 


01075 


1002 20 


'■. 0&Gf. ':> 


88 T 


0:1 076 


1.00040 


'.'0067 '.'' 


SEQ 


0:1 077 


18004 


■:' 0068 •' 


82 E 


0:1 :1 00 


101040 


•'■. 0069 '■'' 


SNE 


01 1 01 


101040 


'-. 0070> 


SNZ 


01 102 


101001 


•■. 007:1 '■' 


SSC 


01 1 01: 


10000:1 


; '0072 ':• 


SRC 


01:104 


101200 


< 007 "; ,' 


SSMi 


0:1 .1 05 


101200 


'•'!0074> 


SPS 


011 06 


100200 


'•' 0075 ':> 


SRHf 


01 :1 07 


100200 


'• 0076 -i 


SPN 


011 1.0 


1.00100 


•:'. 007 7 :• 


SLZ 


011 1.1 ' 


101.100 


<■ 00 1 : ; :■ 


SLN 


011 12 • 


1.01020 


''•' 00 7 9,' 


881 


01113 ■ 


100020 


■: 0080'' 


SRI 


011 1.4 


1010J 


>'■ 008:1 "■< 


!""> !."!' <!'.''. 


01 1 1 5 


10001 


'::0082> 




01116 


101004 


■: 008 ; ' 


O C" ""■ 


011.17 


100004 


':;0084> 


SR3 


01 1 20 • 


1.01002 


■:' 00 85 .:■ 


SS4 


011 21 • 


100002 


''0086'.' 


SR4 


01122: 


101036 


O3087) 


':::■ ':::• '::.< 


01 1 23 • 


100036 


■:' 0086; ':< 


ssr 


01:124 ' 


■]_40040 


i;;0088 ■' 


CRR 


01:125 


140024 


''■'. 0090 > 


CHS 


01 1 26 ' 


1401,00 


■: 009i. :i 


SSF' 


011.27 : 


140200 


<■'. 0097 '■• 


RC8 


01 1 30 


140320 


■:. 009 :• 


CSR 


01 1 31 : 


14040-1 


'70094:.'' 


CI'IR 


01 1 72 ■ 


140407 


•::0095':> 


TCR 


01.133 ■ 


140500 


C0096 ':• 


ssn 


01 1 34 : 


140600 


t 00978' 


SCR 


01 1 35 


141044 


•■ 0096 '.> 


CRR 


01.1 36 ' 


141050 


':'0099:> 


CRL 


01 1 37 


1411.40 


•::0100 ':• 


I CL 


0:1 1 40 : 


141240 


'•':ei0i •• 


ICR 


0114:1 • 


141206 


'80102::' 


ROR 


01142: 


141.206 


v 01038 1 


fllfl 


01147 


141216 


•::0104:' 


RCR 


011 44 ■ 


141340 


< 0105 > 


ICR 


011 45 : 


140010 


'93106::' 


CRL 


01:1 46 : 


140014 


O3107::' 


CRB 


01:1 47 ■ 


1401.04 


•:' 01.08::' 


XCfl 


01:1 50 : 


14011 


<:©109> 


S0R 


01:1 51 : 


1401 1 


■•0110> 


SIR 


01152 • 


140114 


>: 011.18' 


IRX 


01153 : 


140204 


■80112 "> 


XCB 


01154: 


1402:1 


-::0113::' 


DRX 


01 155: 


1402:1 4 


< 9114 > 


CRZ 
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0:1 


156 ■ 


01 


1 57 • 


0:1 


I 60 ■ 


0:1 


1 61 ■ 


01 


'1 62 


01 


1 6": 


01 


:l 64 


01 


165 ' 



1403: Pi^l 


•:■ 01.15 > 


flSfl 


1.4 031 Pi 


•::0116> 


S2R 


1.4S418 


•;: 01.1.7 ::< 


L.L.T 


140411 


<9118> 


L.I...E 


14041.2 


•:: 01.19 > 


LNE 


140413 


•:: 0120 > 


LEG 


1404:1 4 


•::0121':' 


LQE 


1.40415 


•::0122':' 


LGT 
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SECTION 4 
PSEUDO-OPERATIONS 

Pseudo-operation statements are commands (or directives) to 
the assembler or loader, rather than instructions to be 
assembled and executed in a user's program. Various classes 
of pseudo-operation are provided, to control the assembly and 
load modes, assign values to symbols and data constants, 
define macros, link programs, allocate storage, and control 
conditional assembly. The mnemonics of all the PRIME 200 
assembler pseudo-operations are listed in Table 4-1. 
Pseudo operations are described in this section according to 
class, except for those used in Macro definitions (Section 5). 

STATEMENT FORMAT 

Pseudo-operations have an operation field and a variable field 
separated by spaces, the backslash tab character, or a comma 
((see Figure 4-1). In addition, some pseudo-operations 
require a label to be present or absent. Therefore the 
statement format description in the following paragraphs 
includes the label field. 

Constants, variables, and expressions used in pseudo-operations 
conform to the general features defined in Section 2. 

The operation field contains the mnemonic that identifies the 
pseudo -operation. 

The variable field may contain one or more arguments, 
separated by single spaces or commas. Arguments may be 
constants, variables, or expressions as defined in Section 2. 
Arguments for certain operations such as BCI may also consist 
of ASCII character strings. (Spaces and commas occurring 
within such strings are not interpreted as argument delimiters.) 

Symbolic names or other variables used in the variable field 
must be previously defined, unless otherwise stated in the 
pseudo-operation definition. 

Address expressions are evaluated as single-precision values 

and used as an absolute 16-bit memory address. If the relocatable 

mode is in effect during loading, the relocation factor is 

added to the address. Certain statements (DAC, XAC, ***) accept 

the indirect address (*) and indexing (,1) symbols. These 

are interpreted according to whether the extended addressing 

mode is in effect. (See EXD and LXD pseudo-operations.) 
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Table 4-1. Summary of Pseudo-Operations 



Mnemonic 


Definition 


Class* 


ABS 


Set Mode to Absolute 


AS 


BACK (TO) 


Loop Back (Macros Only) 


MA 


BCI 


Define ASCII String 


DA 


BES 


Define Block Ending with Symbol 


ST 


BSS 


Define Block Starting with Symbol 


ST 


BSZ 


Define Block Set to Zeros 


ST 


CALL 


External Subroutine Reference 


ST 


CF1-CF5 


Ignored (Provided for Compatibility with Other 
Assemblers) 


AS 


COMN 


Define Common Items 


ST 


DAC 


Local Address Definition 


DA 


DATA 


Set Data Constant 


DA 


DBP 


Set Double Precision Constant 


DA 


DEC 


Set Decimal Constant 


DA 


ENT 


Define External Entry Points 


ST 


GO (TO) 


Forward Reference 


AS 


EJCT 


Eject Page (Start New Page) 


LI 


ELSE 


Reverse Conditional Assembly 


CO 


END 


End of Source Statements 


A 


ENDC 


End Conditional Assembly Area 


CO 


ENDM 


End of Macro Definition 


MA 


EQU 


Define Variable 


SY 


EXD 


Enter Extended Addressing Mode 


LO 


EXT 


Flag External References 


ST 


FAIL 


Force Error Message 


SP 


FIN 


Insert Literals 


AS 


HEX 


Set Hexadecimal Constants 


DA 


IF 


Conditional Statement 


CO 


IFM 


Continue Assembly if Minus 


CO 


I FN 


Continue Assembly if Non-Zero 


CO 


IFP 


Continue Assembly if Plus 


CO 


IFZ 


Continue Assembly if Zero 


CO 


List 


Enable Listing 


LI 


LSMD 


List Macro Expansions (Data Statements Only) 


MA 


LSTM 


List Macro Expansions (All Statements) 


MA 


LXD 


Leave Extended Addressing Mode 


LO 


MAC 


Start Macro Definition 


MA 


MOR 


More Input Required 


AS 


NLSM 


No Listing of Macro Expansions 


MA 


NLST 


Inhibit Listing 


LI 


OCT 


Define Octal Constants 


DA 


ORG 


Define Origin Location 


AS 


SAY 


List Message to Operator (Within Macro Definitions) 


MA 


SET 


Redefine a Variable 


SY 


SETB 


Set Base Sector 


LO 


SETC 


Set Common Base Address 


ST 


SUBR 


Define Entry Points 


ST 


REL 


Set Mode to Relocatable 


AS 


VFD 


Define Variable Fields 


DA 


XAC 


Define External Address 


DA 


*** 


Dummy Memory Reference Instructions 


DA 



CLASSES: AS - Assembly Control LO 
CO - Conditional Assembly MA 
DA - Data Defining ST 
LI - Listing Control SY 
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Loader Control 
Macro Definition 
Storage Allocation 

Symbol Defining 



REQUIRED 
BY SOME: 
FOR OTHERS, 
MUST BE 
NULL 



BACKSLASH, 
SPACES OR COMMA 



2 SPACES OR C0L.73 




I 



VARIABLE FIELD 



COMMENTS 



i 



NOTE I 



OPTIONAL 



PSEUDO-OP 
MNEMONICS 
(SEE TABLE 4- 1) 



r 



ARGUMENT I 



NOTES 

I. IF MORE THAN 10 SPACES 
FOLLOW THE OPERATION 
FIELD, THE ASSEMBLER 
ASSUMES THERE IS NO 
VARIABLE FIELD AND 
TREATS THE REST OF 
THE LINE AS COMMENTS. 



ARGUMENT 2 



\ 



SINGLE SPACE 
OR COMMA 



/ 



ARGUMENT 



3 



Figure 4-1. General Format of Pseudo-Operation Statements 
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ASSEMBLY CONTROLLING PSEUDO OPERATIONS 

ABS (Set Mode to Absolute) 

Label Operation Field Variable Field 
Optional ABS Must be vacant 



Sets to absolute the assembly and loading mode of all subse- 
quent memory reference instructions. ABS may be terminated 
by REL and vice-versa. The ABS mode is the normal default 
mode of assembly , 



REL (Set Mode to Relocatable) 

Label Operation Field Variable Field 
Not Used REL Must be vacant 

Sets to relocatable the assembly and loading mode of all 
subsequent memory reference instructions. REL may be terminated 
by ABS. 

ORG (Define Origin Location) 

Label Operation Field Variable Field 
Optional ORG Address Expression 

Sets up a new assembler location count equal to the value of the 
address expression. This new origin is considered absolute 
or relocatable depending on the current mode of the assembler 
and loader. In absolute mode, program loading continues at 
the location specified by the address expression. In relocatable 
mode, program loading continues at the location specified by 
the address expression plus the loader's relocation factor. 

If the statement includes a label, the label variable is set 
equal to the location count before the ORG is executed. 
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Examples : 







>:' 000:1 > 


* DE.I 






OZi002> 




0R000 ■ 


000001 


O3003" 1 




0000::! ■ 


00000:1 


<■ 0004 ) 




00002 


0'-! 0060? 


•:' 0O05 > 




0000 '5 : 


15 00610 


<. 0006 '> 




00004 ■ 


12. 006 1:1. 


•;1T3007> 




00005 . 


Gl 00600 


V 0008 > 






000600 


<■ 0009 ':> 
(0010 '.:' 




90 £00 ' 


02 0061 2 


•:. 00:11> 


0BSO 


00601 


Q'l 00 60 a 


C0012> 




00 A 02 


01. 09604 


■:'00O> 




00i~ : l0~: • 


000000 


| :'00:15; 1 




00604 


02 00607' 


i:'0016> 


V 


00605 


02. 0061.0 


'::001?:' 




00606 ' 


000000 


■:'. 001S ':■• 




00607' ■ 


000000 


t. 0015 ■' 


SAVA 


00610 ' 


000000 


O-3020) 


SAVX 


006:1.1 : 


000000 


OI1021-' 


CTR 




000 6 '1 2 


< 0022 ;» 




00612 : 


00000:1 







* DEMONSTRATES REL 
REL 



AND AB'i 



NOP 




NOP 




ST A 


SAVA 


st>: 


SflVX 


IRS 


CTR 


JMP 


ABSO 


ORG 


■" 600 


ABS 




LDfl 


=1 


STA 


*+2 


JMP 


V 


REL.. 




LDfl 


SAVA 


LDfl 


SflVX 


HLT 




DATA 





DATA 





DATA 





END 





START RELOCATABLE 



SAVE REGISTERS 

UPDATE COUNTER 

JUMP TO ABSOLUTE LOCATION 



STARTS AT LOCATION -' 60f 
RETURN TO RELOCATABLE 
RESTORE REGISTERS 
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FIN (Insert Literals) 

Label Operation Field Variable Field 
Optional FIN Not used 

All literals defined since the beginning of the program 
(or the last FIN statement) are assembled into a "literal 
pool", starting at the current location count. Processing of 
subsequent statements begins at the first location count 
following the literals. FIN performs the same functions as 
the END statement, but does not terminate the assembly. By 
using FIN, the programmer can distribute literals throughout 
the program, and possibly reduce the number of cross-sector 
indirect address links that must be formed by the loader. 
(However it is important to make sure that the program 
will jump over the pool of literals and not attempt to 
execute them as instructions.) 

MOR (More Input Required ) 

Label Operation Field Variable Field 
Optional MOR Not used 

When entered as the last statement on a source tape, MOR 
causes the input device to stop. A continuation tape can 
then be mounted. When the computer START switch is pressed, 
assembly continues with the first statement on the continuation 
tape. 

END (End of Source Statements) 

Label Operation Field Variable Field 

Optional END Address expression 

Terminates processing of the source program. All literals 
accumulated since the beginning of the program (or the last 
FIN statement) are assigned locations starting at the current 
location count. 
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In a two-pass assembly, the computer halts on the first pass 
when the END statement is reached. The operator must then 
return the source tape to its starting point and restart the 
computer to begin pass two. (New assembly parameters can be 
specified on the second pass, if additional outputs are 
required. ) 

When the END statement is reached on the second pass, the 
address expression is included in the object text for action 
by the loader, which can be directed to start program execution 
at the specified location. If the address field is null, 
the starting location is assumed to be the first location of 
the program. 

CF1 Through CF5 

Pseudo-operations CF1 through CF5 have no effect on this 
assembler. However, these statements are accepted without 
generating error messages, in order to maintain compatibility 
with other assemblers. 

GO, GO TO (Forward Reference) 

Label Operation Field Variable Field 

Not used GO Statement label 

or 
GO TO 

Assembly is suspended for all statements following this one 
until a statement having the specified label is found. The 
GO (GO TO) statement must point forward to a statement label 
that is not yet defined- An error condition exists if the 
assembler reaches an END, MAC, or ENDM statement before finding 
the specified label. 

Examples 

GO TO K31 

GO T174 

IF (OPTION .EQ. 3) GO TO AL28 

LDA X : ADD Y : GO TO Z 20 
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LISTING CONTROL PSEUDO-OPERATIONS 
LIST (Enable Listing ") 

Label Operation Field Variable Field 
Not used LIST Not used 

Causes all statements to be listed except those generated by- 
macro expansion. This is the assembler's default mode - a 
LIST statement is not needed unless a NLST statement has 
previously inhibited listing. 

NLST (Inhibited Listing) 

Label Operation Field Variable Field 
Not used NLST Not used 



Inhibits listing of all subsequent statements until a LIST 
statement is encountered. LIST and NLST may be used together 
in source text for selective control over the sections to be 
listed. The LSTM, LSMD, and NLSM statements provide control 
of listing for macro definitions; for details, see Section 5. 

EJCT (Eject Page) 

Label Operation Field Variable Field 
Not used EJCT Not used 



Causes the listing device to eject the page (execute a form 
feed), print the current page title and page number, and feed 
two blank lines before resuming listing. This function is 
operable only with devices which have a mechanical form feed 
capability, such as a line printer. 
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LOADER CONTROLLING PSEUDO OPERATIONS 

The following statements generate special messages in the 
object text that provide control information to the linking 
loader. 

EXP (Enter Extended Addressing Mode) 

Label Operation Field Variable Field 
Optional EXD Not used 

Notifies the loader that extended (32K) addressing mode is 
in effect. The loader processes subsequent indirect address 
words as having a 15-bit address field and an indirect bit, 
but no index bit. The CPU must be set to extended addressing 
mode by an E32S instruction. 

LXD (Leave Extended Addressing Mode) 

Label Operation Field Variable Field 
Optional LXD Not used 

Causes loader to leave extended mode and resume 16K addressing 
mode (the normal default mode of the loader) . In this mode 
the loader processes indirect address words as having a 
14 bit address field, an indirect bit, and an index bit. 
However, the operator can override the LXD mode during loading, 
and force extended addressing. 

SETB (Set Base Sector) 

Label Operation Field Variable Field 

Optional SETB Address expression 
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Examples : 








885888 < 8803 > 


ORG 


" 5000 


05080 : 


81. 85825 C0004> 


JMP 


++21 




885801 •; 0005 ':■• 


SETB 


+ 


05825 • 


<. 0886 > 


BSS 


28 



Specifies a base sector and starting address for cross-sector 
indirect address links. 

Normally the loader generates address links starting at 
location '100 of Sector zero. This statement permits the 
loader to generate some address links in the same sector 
as the program which refers to them. Memory locations to 
be used for this purpose must be reserved by the program. 



START LINKS AT BEGINNING OF SECTOR 5 
.JUMP OVER LINKS 

ALLOCATE 28 LOCATIONS FOR ADDRESS 
LINKS STARTING AT -5801 



The first SETB pseudo-op for a given base sector determines 
the location at which the indirect word table will begin 
in that sector. The table then grows upward in successively 
higher locations. Other SETB pseudo-ops referencing the same 
sector do not re-origin the table for that sector — table 
filling resumes where it left off. During loading, the B- 
Register setting may be used to assign a starting address 
for the links; if so the B-Register setting is treated like 
a SETB pseudo-operation preceding the first word to be 
loaded. 

At the end of each subprogram, the base sector reverts to 
sector zero. The loader retains knowledge of the last 
location used in each base sector. When the base sector 
reverts to zero, no indirect words are lost. 

Note that in general cross-sector reference pools may grow 
unpredictably and overwrite program areas during loading, 
so that extreme care must be used in assigning SETB areas. 
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DATA DEFINING PSEUDO-OPERATIONS 



This group 
locations 
may be spe 
Simple cod 
hexadecima 
notation t 
the notati 
data words 
double pre 



of pseudo-operations is used to initialize memory 
to known starting values. Data and address constants 
cified in a variety of formats, for coding convenience 
ing convention. 5 allow the programmer to use ASCII, 
1, octal, or fixed and floating point decimal 
o specify constant values. The assembler interprets 
on and automatically generates one, two, or more 

in the proper internal binary format for single or 
cision, fixed or floating point arithmetic. 



DATA (Set Data Constant) 

This is the basic PRIME 200 pseudo-operation for presetting 
memory locations to equal expressions, ASCII strings, or 
numerical constants. Constants can be expressed in decimal, 
octal, or hexadecimal form. Decimal quantities can be specified 
in single or double precision, fixed or floating points, formats 
The basic format of the DATA statement is: 



Label 



Operation Field Variable Field 



Optional DATA 



One or more expressions, 
ASCII strings, or numerical 
data constants 



The current location is set equal to the expression(s) in the 
variable field. The variable field may contain any number 
of subfields, separated by commas. Subfields are assembled 
in consecutive locations starting with the leftmost subfield. 
If an expression requires more than one location (e.g. 
floating point) , consecutive locations are used. 



ASCII Strings : ASCII character strings are specified by the 
letter C followed by the string enclosed in apostrophes. ASCII 
characters so specified are packed two per word during assembly. 
Single characters are left- justified with the remainder of the 
word filled with zeroes. The number of characters per statement 
is not limited. 

The string portion of a data statement cannot be continued 
on the next line. Within the string itself, the (!) character 
permits the assembler to encode restricted characters such 
as ' (end of string), < (start of macro arg. ref.) or CR 
(end of statement). Examples: 



£15026 
65827 
05030 
05831 
05832 
05833 
05034 



148648 
140782 
141704 
142706 
140782 
123661 
131.240 



<. 0008 > 

<:;0009> 



<. 0010 > 
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DAT ft 
DATA 



■ft' 

' RBCDEF -' 



DflTft C" RB ! -' i; 



Numerical Constants : The form in which a constant is specified 
determines whether the assembler will process it as single or 
double precision, fixed or floating point. The general format 
for numerical constants is: 



(+) Number 

^ Z 

Number 



E 
EE 



( + ) mm 



][bb « nn ] 



Decimal 
Exponent 



Binary- 
Scaling 



If the number part of the statement is a decimal integer or 
fraction, it can in some cases be modified by a decimal 
exponent (E for single precision, EE for double precision) 
or a binary scaling factor (B for single precision, BB for 
double precision). Table 4-2 summarizes the legal combinations 
of number, exponent, and scaling designators. 

Fixed Point Single Precision : Constants in fixed point 
single precision format are assembled to form a sign bit and 
15 magnitude bits, as shown in Figure 4-2A. The CPU internally 
treats such arithmetic quantities as binary fractions ranging 
between -1 and slightly less than +1. The assembler, however, 
handles single precision words as signed integers ranging 
between -32,768 and +32,767. Constants in DATA statements 
may be expressed as integers within that range, using decimal, 
octal, or hexadecimal notation. 



Expressions must be capable of being evaluated as single- 
precision constants only. Variables used in expressions must 
be previously defined. 



Examples : 








Hexadecimal 


Octal 


Decimal 


Expressions 


X'12AB» 


0'1234' 


12 


X*2 + 3 


X'-12AB' 


0'-1234' 


-12 


ALPHA 


$12AB 


0»1234 





Y .AND. '77 


$ - 1 2AB 


'1234 






X ' 1 2AB 


'-1234 " 






$EFFF 


■i '077777 


32767 




$8000 


•100000 


-32768 





1.23B6 (using binary scaling) 
1.23E3B12 (using decimal exponent 
and binary scaling) 
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Table 4-2. Numerical Formats in DATA Statements 



Form of Number 


Decimal 
Exponent 
(E or EE±jrim) 


Binary 
Scaling 
(B or BB±nn 


Assembler Inter- 
prets Constant As: 


Expression using 
Symbolic Variables 





— 


Single Precision 
Fixed Point 


Hexadecimal 






Octal 






Decimal Integer 






Decimal Integer 
or Fraction 


E 


B 

B 


EE 


BB 
BB 


Double Precision 
Fixed Point 


EE 




Double Precision 
Floating Point 


E 




Single Precision 
Floating Point 


Decimal Fraction 
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BIT I 

l~S 



r— CPU CALCULATIONS ASSUME BINARY f 

POINT IS HERE I 

2 3456789 10 II 12 13 14 15 16 f 



-J 1 1 1 1 1 I I i i i i ■ i 



* . ASSEMBLER 

• v ^ ASSUMES 

S,6N 15 MAGNITUDE BITS B^'uS? 

LESS OTHER- 
WISE SPECI- 
FIED BY "B" 
NOTATION 

A. DATA FORMAT 



BIT J 2 3 4 5 6 7 8 9 10 II 12 13 14 15 16 

S 



i 1 1 1 1 I I i I ' i I ■ i 



M M t t t t M M t t ft 

LSSSF_22^ ,B ' 1 *> Bl B2 B3 BA B5 B6 B7 w B9 Bl ° Bll BI2 BI3 BI4 BIS 
BINARY POINT » 

POSITION , f 

ASSEMBLERS NORMAL BINARY POINT ' 

B."B" CODES FOR BINARY SCALING 



Figure 4-2. Single Precision Fixed Point Constants 
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Powers of 10 (E) and Binary Scaling (B) : For single-precision 
decimals only, the E and B notation provides flexibility in 
scaling data constants. Expressions with binary scaling are 
formed by a decimal integer or fraction in the range from 
-32768 to +32767, followed by the letter B and an integer 
from -1 to +15. 



Examples : 



Assembled As : Decimal Equivalent 



12.5B6 001 100 A 100 000 000 6400 

B6 

0.5B8 000 000 001 000 000 64 

A 



5B8 000 001 010 000 000 640 

A 



B8 

A° ' 
B8 



In general terms, a constant entered as K^QBn i- s converted to 

K ? (2~ n ), where K.. „ is the decimal constant, K 2 is the same 

constant expressed as a binary fraction, and n is the number 
following the letter B. Positions for B values -1 through 15 
are shown in Figure 4-2B. Any bits of the repositioned 
binary fraction that extend to the left or right of the 
15 magnitude bits of the data word are truncated. 

In the first example, the fraction 12.5 is converted to the 
binary value 1 100.1 and positioned in the 16 bit data word 
so that the binary point is at position B6. The result is 
equivalent to decimal 6400. 

If an E code is present, the decimal value is multiplied by 
the power of 10 specified by the integer following the E before 
it is converted to binary. Thus a constant entered as K^oEmBn 
is converted as K 2 (10 m ) (2~ n ) . The exponent, m, may be 
negative (-) or positive (+ or unspecified) . 

In fixed-point single precision constant expressions, an 

exponent (E) cannot be used unless binary scaling (B) is 

also specified. If E is used alone (as in "5E2") the expression 
is interpreted as floating point (described later) . 
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Fixed Point Double Precision : The assembler handles fixed 
point double precision words as integers ranging between -(2^0) 

and +(2 30 -l). (2 30 = 1,073,741,824.) Such constants are 
assembled as two consecutive data words, in a format determined 
by the CPU's double precision arithmetic procedures. (See 
Figure 4-3A.) The first word must load in an even location; 
if the location count happens to be odd, one location is 
skipped. Negative numbers are represented in two's complement 
notation, but bit 1 of the second word is always 0. 

When expressed in DATA statements, fixed-point double precision 
constants must include a binary scale factor (BBn) . A decimal 
exponent (EEn) is optional. 

The BB codes for binary scaling are interpreted in the same 
way as single precision B codes, but extend into the second 
word of precision as shown in Figure 4-3B. The EE code, if 
present, is interpreted in the same way as single precision 
E codes and can only be used when a BB code is also present. 



Examples : 



Assembled as : Decimal Equivalent 



12.5BB6 word 1 001 100 100 000 000 6400.00000 
or 6.4EE3BB15 word 2 000 000 000 000 000 

7BB16 word 1 000 000 000 000 011 3.50000 
word 2 100 000 000 000 000 

Bits of the scaled binary quantity that extend to the left 
of word 1 or right of word 2 are truncated. 
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BIT I 2 3 4 5 6 7 8 9 10 1 1 12 13 14 15 16 f 



t 

ALWAYS 



WORD 
1 


S 1 


■ 


i i i i i i i i i i i 


i 


t 

SIGN 




15 MOST SIGNIFICANT MAGNITUDE BITS 




WORD 

2 


° 


1 


i i i i 


i i 



ASSEMBLER 
ASSUMES 
BNARY POINT 
IS HERE UN- 
LESS OTHER 
WISE SPECI- 
FIED BY"BB* 
NOTATION 



15 LEAST SIGNIFICANT MAGNITUDE BITS 



A. DATA FORMAT 



WORD 
I 



J L 



J L 



J L 



J L 



J L 



BB CODES 
FOR BINARY 
POINT 
POSITION 



t t M t t ! t M t It t M t 

•BB BB BB BB BB BB BB BB BB BB BB BB BB BB BB BB BB 
-I I 2 3 4 5 6 7 8 9 10 II 12 13 14 15 



WORD |J 



J L 



J L 



J L 



J L 



tttttttttttttttt 

» BB BB BB BB BB BB BB BB BB BB BB BB BB BB BB BB 
15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 



B. "BB" CODES FOR BINARY SCALING 



Figure 4-3. Double Precision Fixed Point Constants 
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Single Precision Floating Point : Floating point data formats 
are defined by the procedures of the floating point math 
routines in the FORTRAN/Math Library. (See Figure 4-4.) 

Single-precision floating point quantities are expressed by 
a decimal fraction, with or without decimal exponent (Emm). 
(Binary scaling must not be specified.) 



Examples 






95046 


942100 


'■. 0017 > 


05047' 


000000 




05050 


040321 


•:: 0018 > 


05051 


165605 




05052 


137456 


(0019) 


05052 


012172 




05054 


02456:;;: 


< 0020V 


05855 


045312 





DflTfl 1 28E2 

DRTfl 1. 28 

DFlTfl -1. 28 

DfiTfi 1. 28E-14 



The assembler converts the specified values to an 8 bit binary 
exponent and 23 bit binary fraction in two successive words, 
as shown in Figure 4-4A. The exponent is represented in 
excess-128 notation, and can range from 2~127 t0 2 + l27 (roughly 10" 38 

to 10 +38 ) . An error printout occurs if the exponent exceeds 
this range. The assembler automatically generates a normalized 
fraction of the largest possible value less than 1. Numbers 
specified in this format have about 6.8 significant decimal 
digits (+ 8,388,607) . 

Negative numbers are formed by generating a positive number 
of the specified magnitude and then forming the two's 
complement of both data words, including the exponent. The 
number zero is assembled as two consecutive all-zero data words. 

Double Precision Floating Point : Double-precision floating 
point quantities are expressed by a decimal integer or fraction 
with a decimal exponent (EEmm) . (Binary scaling must be 
specified. ) 

The assembler converts the specified value to an 8-bit binary 
exponent and 39-bit binary fraction, in three successive words, 
as shown in Figure 4-4B. The exponent is represented in the 
same excess-128 notation as single-precision floating point. 
The assembler automatically generates a normalized fraction 
of the largest possible value less than 1. Numbers specified 
in this format can have about 11.5 significant decimal digits 
(+549,755,000,000). 

Negative numbers are formed by generating a positive number 
of the specified magnitude and then taking the two-s complement 
of all three data words, including the exponent. The number 
zero is assembled as -three consecutive all-zero data words. 
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WORD 
I 



V 



EXP 

' I ■ i L 



J I L 



J L 



_/V_ 



SIGN 



EXPONENT (EXCESS 
128 NOTATION) 



7 MOST SIGNIFICANT 
BITS OF FRACTION 



WORD 
2 



_i__j i 1 L 



J I L 



D 



16 LEAST SIGNIFICANT BITS OF FRACTION 



A. SINGLE PRECISION (REAL FORMAT) 



WORD 
I 



J L 



EXP 
_l I I L 



zrz 



J L 



SIGN EXPONENT (EXCESS 

128 NOTATION) 



7 MOST SIGNIFICANT 
BITS OF FRACTION 



WORD 
2 



J L 



16 NEXT-MOST SIGNIFICANT BITS OF FRACTION 



WORD 
3 



J L 



16 LEAST SIGNIFICANT BITS OF FRACTION 



B. DOUBLE PRECISION 



Figure 4-4. Floating Point Word Formats 



] 






^ 
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Examples : 



05056 
05657 
05060 
05061 
05062 
05063 
05064 
05065 
05066 



042100 C 0021 > 

000000 
000006 

O5F00 ■:: 0022 :.< 

000000 
000000 

024562' < 0023 > 
045312 



DATA 



DflTfl 



1. 28EE2 



-1. 2SEE2 



DflTfi 1. 28EE-14 
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Repeated Constants : Constants that do not start with a digit 
or a decimal point may be preceded with a repeat count "n" 
(positive integer) which will cause the value to be generated 



n times. 

Examples : 

3X*12AB' 

9CXX' 

15'16 

6(ALPHA+1) 

3(1. 5E6) 

5(-0.012EE-3) 

Mul tiple and Implied DATA Statements : A DATA statement can 
contain more than one constant, separated by commas. 
Constants are converted to the appropriate number of data 
words and loaded into consecutive memory cells starting with 
the current location count. 

The assembler will process any statement that starts with a 
constant (not counting the optional label field) as an implied 
DATA statement. 



Examples : 



DATA 16 

DATA 3, 10, -2, -3, 0, 0, 10, AP3 

DATA 3, '12, X--02', -X'3', 20'0', $A, AP3+2-1 ; 

16, 3, 10, -2, XYZ-2 

100 

DATA -4, 1.23E4, +1176EE3BB24 , 16(0.0) 

DATA 4(X6*2-1) 
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Summary : The following examples show many varieties of 

DATA statements. Table 4-2 summarizes the legal combinations 

of constants, B and BB codes, and E and EE codes in numerical 

values . 



05156 


000020 


<:003i ■■ 


05157 


000003 


<:0032> 


05160 


000012 




05161 


177776 




051.62 


•1 77771^ 
1. ( t ill 




05163 


000006 




05164 


000006 




05165 


000012 




05166 


005170 




05167 


131640 




05178 


00. 00000 


•r0033> 


051.71 ' 


000003'. 


<. 0034 ;• 


05172 ■ 


000012 




05173 ■ 


177776 




05174 ■ 


177775 




05175 ■ 


000000 




05176 ■ 


000000 




05177 


000000 




05200 : 


000000 




05220 : 


000000 




05221 : 


000012 




05222 . 


005171 





DfiTfl 
DRTR 



16 

3\. 18.. -2.. 



-3, 0.. 9.. 16.. RP3 



rp: 



DflC 
DRTR 



:+::+: 



'12i 



-0 c: 



X" 3-' , 29" 9" , f-R, RP3+2— 1 
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DEC (Set Decimal Constant) 



Label 



Operation Field Variable Field 



Optional DEC 



One or more decimal, octal, 
or hexadecimal constants 
(separated by commas) 



This statement is provided for compatibility with other 
assemblers. Each constant in the variable field is evaluated 
as a decimal constant, converted into one or more binary words, 
and loaded starting at the current location count. All formats 
accepted by the DATA statement may be used with DEC except 
the repeated constant format (3X'12AB'). (See Table 4-2.) 
Hexadecimal and octal constants are interpreted as single 
precision fixed point. 



Examples : 




05302 


000020 


•:'.0040> 


05303 


000003 


'■. 0041 > 


05304 


0000:12 




05305 


000002 




05306 


000032 




05307 


000017 




0531.0 


000123 





DEC 
DEC 



16 



10, 2, :«:■- lft" , *F, '- l: 
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DBP (Set Double Precision Constant) 



Label 



Operation Field Variable Field 



Optional DBP 



One or more decimal, octal, 
or hexadecimal constants 
(separated by commas) 



This statement provides compatibility with other assemblers. 
Each constant in the variable field is evaluated as a decimal 
constant, converted to double precision binary format, and 
loaded in consecutive memory cells starting at the current 
location count. The format of each expression determines 
whether the result will be fixed or floating point. For 
fixed point quantities, the assembler is forced to assign 
the first word to an even location count. (If the current 
count is odd, it is skipped.) The repeating constant format 
of the DATA statement is not permitted. 



E 


xamples : 




0531.4 


000000 


■:' 9043 > 


05315 


000020 




053:16 


000000 


•'9044} 


0531.7 


000003 




05320 


000000 




05321. 


040316 




0532? 


000000 




05323 


000032 




05324 


000000 




05325 


000017 




05326 


000000 




05327 


00012.3 




05330 


0403.16 


•:: 0045 ':■' 


05331 


134121 




05332 


127075 


''0046> 


05333 


114301 




05334 


000000 




05~'~'5 


000000 




05336 


040740 




05337 


000000 





DBP 16 FIXED POINT 

DBP 3, 1. 23B6, X' 1R' , *F, ' 123 



DBP 1. 23 FLOATING POINT 

DBP -456. 32E10, 0. 0, 6. 
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OCT (Set Octal Constant) 



Label 



Operation Field Variable Field 



Optional OCT 



One or more octal constants 
(separated by commas) 



This statement is provided for compatibility with other 
assemblers. Each constant in the variable field is evaluated 
as an octal constant, converted to single precision fixed point 
binary, and loaded at the current location count. Only the 
following constant forms are allowed. 



Examples : 




05340 


00001 2 


■:'. 0047 > 


0534:1. 


070017 


(. 0048 '> 


05342 


00032:1 




05343 


000677 




05344 


1 *'* r' r* f' »*' 


< 0049 > 


05345 


X i' i'' f f i'° 




05346 


1 1- f t f-D 




05347 


000177 




05350 


000177 





OCT 12 

OCT 70017, - 



' 321, 677 
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HEX (Set Hexadecimal Constants) 



Label 



Operation Field Variable Field 



Optional HEX 



One or more hexadecimal 
constants (separated by 
commas) 



This pseudo-op is provided for compatibility with other 
assemblers. It converts the hex constants within the variable 
field to single precision binary values and loads them in 
consecutive locations starting at the current location count. 
Only the following constant forms are allowed. 



Examples : 



05351 
851:52 
05353 
05354 
05355 
05356 
05357 
05360 
05361 
05362 



0.11253 ''.0050; 1 
000017 ':>305i::' 

000017 

0000:1 7 

000017 

0000:17 

011253 <0@52> 
011253 
011253 
011253 



HEX 
HEX 



12HB 

F, *F, -FFF1, 



-*FFF1, *-FFFl 



HEX 



$12flB, +12HB, +*12RB, $ +12RB 
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VFD (Define Variable Fields) 

Label Operation Field Variable Field 

Optional VFD One or more subfields of 

the form: 

Field Size, Value 

This statement permits 16-bit data words to be formed in 
subfields of varying length by pairs of constants (field size, 
value) in the variable field. The first constant of each pair 
specifies a number of adjacent bits, starting at the most 
significant end of the 16-bit word. The second constant of 
a pair is the value to be loaded. Subsequent field size value 
pairs load less significant subfields of the 16-bit word. For 
any pair, if a value exceeds the specified field size, the 
more significant overflow bits are exclusive OR'ed with the 
subfield to the left. (No error message is generated.) 
If the entire word is not specified, the least significant end 
is filled with zeroes. An error message is printed if the 
assembler attempts to load more than 16 bits. 

Examples : 

VFD 8,C*A*-2, 8, 

VFD SZ/4, X, SZ/4, Y, SZ/4, Z, SZ/4, X'F' 
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BCI (Define ASCII String) 



Label 



Operation Field Variable Field 



Optional BCI 



'STRING; (where ' is any 
non-zero, non-digit delimiter) 

or 
#, STRING (where # is the 
number of character pairs) 



This statement loads ASCII character strings by packing the 
specified ASCII characters two per word, starting with the 
most significant 8 bits. Assembled words are loaded starting 
at the current location count. 

In the first format, the string is delimited by any character 
other than zero or a digit; 

BC I ■' AB ■' 

BC I /ABC3450X/ 



65365 


140702 


< 0056 ) 


05366 


140702 


<005?> 


05367 


141663 




05370 


132265 




05371. 


130330 





If an odd number of characters is specified, the least 
significant half of the last word is padded with zeroes. 

In the second format, the character string is preceded by a 
word count (the number of characters divided by 2 and rounded up) 



05372 


120240 


■:; 0058 > 


05373 


120240 




05374 


120240 




05375 


: 120240 




05376 


120240 




05377 


120240 




05400 


140702 


C 0059 > 


05401 


140702 


< 0060 > 


05402 


141662 




05403 


131664 




05404 


130330 




05405 


120240 


•'. 0061 '> 


05406 


120240 




05407 


120240 




05410 


120240 




05411 ■ 


120240 




05412 : 


120240 





BC I * 



* C±2 SPACES > 



BCI 
BCI 



BC I 



1, flB 

4, ABC2340X 



<±2 SPflCES> 
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DAC (Local Address Definition) 



Label Operation Field Variable Field 



Optional DAC 



or 



DAC* (indirect 
addressing) 



Address Expression 

or 

Address Expression, 1 
(Indexing) 



This st 
consist 
and ind 
express 
address 
referen 
DAC are 
and the 
mode is 



atement loads the current location with an address word 
ing of up to 15 address bits, with optional indexing 
irect address bits. The address is specified by the 
ion in the variable field. Indexing and indirect 
ing may be specified symbolically as in memory 
ce instructions (* and,l). Address words formed by 
subject to the effects of the EXD pseudo-operation 
E16S, E32S, and E32R instructions. If relocatable 
in effect the loader performs relocation during loading 



Examples 



054:13 


00. 


77777 


< 0062 '> 


05414 


©0. 


0517:=: 


< 0063 '> 


65415 


20. 


05227 


>'. 0064 > 


05416 


49. 


00003 


>:! 0065 > 


05417 


60. 


00020 


(. QB6& y 


05420 


00. 


00000 


i:.006?'> 



X123 



?> SUB1 



DflC 


ALPHA 


DflC 


AP3+3 


DflC 


XV2, 1 


DflC* 


K31/2+3 


DflC* 


- 20, 1 


DflC 


:+■.:+■. CTVPICAL 



SUBROUTINE EMTR?* 



In the assembler, the DAC pseudo-op generates a 16-bit 
constant. The loader truncates this constant to 14 bits 
if in the LXD mode, 15 bits if in the EXD mode, or does not 
truncate it if absolute. The loader merges the index bit 
with the address constant. It merges the indexing bit in 
normal addressing mode, and ignores it in extended (E3Zb) 
mode. 
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XAC (External Address Definition) 



Label 



Optional 



Operation Field 

XAC 

or 

XAC* (Indirect 
addressing) 



Variable Field 

External variable 

or 

External Variable, 1 
(Indexing) 



Generates the same type of data word as DAC. However, the 
variable field is interpreted as an external variable that 
has no relation to, or conflict with, an internal variable 
of the same name. 



Examples : 




05421 : 98. 00006 


< 0068 > 


05422 : 80. 00000 


<: 0863 > 


05423 : 80- 00000 


O3070} 


05424 : 40 80080 


< 0071 > 


05425 : 40. 00808 


<0872> 



XAC 


FLAGS 


XAC 


R3* 


XAC 


T*l, 1 


XAC* 


T$l 


XAC* 


T$l, 1 
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*** (Dummy Memory Reference Instruction) 

Label Operation Field Variable Field 

Optional *** Address Expression 

or or 

**** (Indirect Address Expression, 1 
Addressing) (Indexing) 

Causes the assembler to create a dummy memory referencing 
instruction with zeroes in the op-code field. Indirect 
addressing is indicated by an asterisk, as usual (resulting 
in a four-asterisk operation field) and indexing may be 
specified. This statement is used when the op-code is to be 
calculated and placed in the op-code field at run time, prior 
to execution. 



4-31 



VARIABLE (SYMBOL) DEFINING PSEUDO-OPERATIONS 

Variables used as address symbols are usually defined when 
they appear in the label field of an instruction or pseudo 
operation statement. Symbols so defined are given the numerical 
value of the statement's location count. The EQU and SET 
statements make it possible to equate symbols to any numerical 
value, even ones that lie outside the range of addresses in a 
program. 



EQU (Define Variable) , 
SET (Redefine Variables) 



Label 



Operation Field . Variable Field 



Format A Contains a EQU or SET 
variable 



Address Expression 



Format B Blank 



EQU or SET 



One or more symbol 
equality expressions 
(separated by commas) 



In format A, the variable in the label field is equated to 
the address expression. Any variables used in the address 
expression must already be defined: 



000883 '..8871';:' I 

877777 l '8874> flLPHH 

177777 <0@75> PRIME 

877773 <8876::< BETR 



EQU 


3 


SET 


™> ■"• "•? ,£• -? 


EQU 


■- 177777 


SET 


RLPHR-4 



In format B, symbols are assigned numerical values by equality 
expressions in the address field. One or more equality 
expressions can be used, separated by commas: 



888883 < 8877 '> 

834777 >::8878> 

888822 >' 8879 > 

835376 < 8888 > 



EQU 1=3 

EQU .J=*39FF.. K"' 7777, L=C RZ' 

SET K=18 

SET K>J+*FF 



Formats A and B can be combined in a single statement: 
888883 <©081> I SET 3, J=*-39FF.. K-" 7777 

EQU and SET perform the same fixnct ions ; however, a variable 
defined by EQU may not be redefined, while a variable 
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once defined by SET may be redefined by subsequent SET 
statements without causing an error message. 

Examples : 







C8001> +DEM 


8NSTRFITES 


EQU RND SI 






< 0002 ) 


REL 






880828 


<80@3> CHflNl EQU 


-' 28 




000015 


•::8884::' STRTRDR SET 


BUFl 


00000 


£100001 


C 8865 ':■> 


NOP 




00001 


000081 


<■. 8886 ':■< 


NOP 




00002 


888881 


i:;800?> 


NOP 




80003 


82. 888:1.5 


< 6008 > 


LDR 


STRTRDR 


00084 


84. 88828 


'■'8009'.:' 


SIR 


CHRN1 


80085 


888081 


< 8618 > 


NOP 




08806 


886801 


<@011> 


NOP 




88887 


888881 


':'.0012> 


NOP 






88884:1 


aziei:?;' 


SET 


STRTRDR 


00010 


82. 88841 


<®&±4> 


LDR 


STRTRDR 


00011 


84. 88828 


':'.8815> 


STR 


CHflNl 


00012 


08888:1. 


■:: 8816 > 


NOP 




88813: 


888801 


<881?::' 


NOP 




88814 


888801 


>::eei8::' 


NOP 




88064 


888865 


•:: 8821. > 


END 





DMA CHANNEL 1 

STARTING ADDRESS I/O TRANSFER 



SET STARTING ADDRESS TO BUF'.. 



STRTRDR=BUF2 CHANGE STARTING ADDRESS 

SET STARTING ADDRESS TO BUFi 



BUFl 


990015/ 


0004 


0019 




buf?;: 


000041/ 


0013 


0020 




CHflNl 


080020 


0003 


0009 


0015 


STRTRDR 


080041 


0004 


0008 


0013 



0014 
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STORAGE ALLOCATION PSEUDO-OPERATIONS 



BSS (Block Starting with Symbol) , 
BES (Block Ending with Symbol) , 
BSZ (Block set to Zeroes ) 

Label Operation Field Variable Field 

Optional BSS, BES or BSZ Expression that specifies 

number of words to be 
allocated 

These statements allocate a block of words of the size specified 
in the variable field, starting at the current location count. 
If there is a label, it is assigned to the first word of the 
block (BSS and BSZ) or to the last word of the block +1.(BES). 
For BSZ, all words within the block are set to zeroes. 

Example s : 

LI BSS 20 

BSS (I+3)/2 

Tl BES 40 

BES N*3-2 



Zl BSZ 100 

BSZ (AB-2)*3 



4-34 



SETC C s et Common Base Address) 

Label Operation Field Variable Field 
Not used SETC Address expression 

The address expression specifies a location near the top of 
memory to be used by the loader as the COMMON base (the highest 
location in a pool of common items). In systems with over 
16K of memory, the expression specifies an address in the 
current 16K of memory. Variables in the address expression 
must be defined and the result must be absolute. 

Examples : 

SETC '17770 

SETC END- 8 
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COMN (Define Common Items) 



Label Operation Field 
Optional COMN 



Variable Field 

One or more variables 
(separated by commas) 



This statement loads common variables in the COMMON area at 
the top of memory. Each of the variables in a COMN statement 
is assigned an address starting with a common base selected 
by the loader or set by a SETC statement. Variables are 
assigned addresses in the order they appear in the variable 
field, and addresses are assigned in decreasing order. The 
loader keeps track- of the last COMMON address assigned, and 
in subsequent COMN statements continues to assign lower 
COMMON locations in sequence, until another SETC statement 
is encountered. 





Examples : 










< 0001 ','■ 


+PROC 


RAM F 






C0002> 


REL 








'■. £1003 > 


SETC 


"i: 




0137'??' 


O3004) 


COMN 


Flfl.. 




013776 










013775 








00000 


02. 00004 


'•'' 0005 ';■ 


LDR 


=1 


0000.1 ' 


0--1 13777 


>.. 0006 '•'' 


STfl 


flfl 


0000.':' : 


12. 13775 


':'.0007':' 


IRS 


AC 


00003 : 


000000 


O3008> 


HLT 






000004 


'.' 0009 > 


END 




00004 : 


00000:1 









FIB.. AC 



SET COMMON BASE 

ASSIGN THREE LOCATIONS IN COMMON 



SET FLAG flfl 
UPDATE COUNTER AC- 
FINISHED 



HA 
AB 
HC 



013777/ ©004 0006 
013776/ 0004 
013775/ 0004 0007 
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O300:l> +PROGRRM B 

<'.0&&2':> * 

OiiQQ ";:.':< REL 

(0004) SETC 

01.3777 >::0005> COMN 

01377i ; ' : : 

013775 

013774 

0P000 1 02. 1.37' 7 7 O3006'> LDfl 

00001: 1.00040 <0007> SZE 

02' 12. 1 3 7" ; ; ' -I >:' S > I R S B D 

00001 02. 000 01-: '-0009> LDH =1 
90004 • 04 i":77'i : "; •:: 001.0 > SIR BB 

£ '■. 1 2' '..< E N D 



"13777 SET COMMON BASE 

BR, BB, BC, BD ASSIGN FOUR LOCRTIONS IN COMMON 



BR 



CHECK PROGRRM FLRG 
UPDATE COUNTER BD 
SET FLRG BB 



0HHt1ir> 



!-l k-1 k.1 1:1 1 -i '.' 



BR 
BB 
BC 
BD 



01 3777/ 0005 000^ 

01.3 7* 7 £./ O005 0010 
013775/ 0005 

013774/ 0005 0003 



C 
C 
f: 



PROGRRM C < FORTRAN > 

DECLARE COMMON IN THE REVERSE ORDER OF PMR EXAMPLES 
COMMON OF, HE, CD. CD, CB, CR 

B 



C". CHECK FLRG OF PROGRRM 

IF ':'CB::' JO, 20, 10 
fitfOOrtO JMP OOOOOO 
LINK. 00 y 000 
CRLL 1*22 
DRC CB 
COUNTER CE 
SNZ 

JMP _20 
CE=CE+1. 
SET FLRG OF PROGRAM C 



00000 J. 

O0OOR2 

C UPDATE 

000003 

OO0GO4 

10 

C 

0000015 

000006 

fiOOOO? 

OOO0J 

OOO011 

000012 
20 



CRLL 

DRC 

CRLL 

DRC 

CRLL 

DRC 



CF-1 



00001 3 
OOOOJ 4 
000015 
OOOOJ 6 

000017" 
000020 
000021 



STOP 



EHZ 



(•'(00005 
000013 

000022 
000023 



LINK 

LDR 

CRLL 

CRLL 

DRC 

CRLL 

DRC 

JMP 

DRC 
DEC 
LINK 
OCT 
'OCT 
LINK. 



L*22 

OF. 

fl*22 

=•' 040300 

H*22 

CE 

...20 

—' OO0OO1 

0*12 

H*22 

OF 

F*HT 

-■=■" OOOOOi 
000017 

...10 

..20 

=•' 040300 

040300 

FtOOOOO 

=•' (3O0OO1 
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PROGRAM LINKING PSEUDO -OPERATIONS 



This group of statements coordinates the interaction of the 
assembler and loader in resolving address references between 
main programs and external subroutines. EXT and CALL are 
used in main programs to identify external names. ENT and 
SUBR are used in subroutines to tell the loader what names 
appear in the subroutine. 

EXT (Flag External References) 

Label Operation Field Variable Field 

Optional EXT One or more external 

entry point names 

The names appearing in the variable field of this statement 
are flagged as being external references. Whenever other state- 
ments in the main program make reference to one of these names, 
a special block of object text is generated that notifies the 
loader that it must fill in the address properly. (The 
assembler fills the address fields with zeroes.) If the 
loader encounters any EXT statements while loading a main 
program, it will print the MR message after loading is complete, 
to notify the operator that the external subroutines containing 
the names must be loaded also. 

Names defined by the EXT pseudo-op are unique only in the first 
6 characters (Loader restriction) and should not appear in a 
label field internal to the program. 

Example s : 

LDA TST2 



EXT TST2 

If TST2 is a location in an external subroutine, the EXT 
statement is required. Otherwise the loader will be unable 
to resolve the address reference. 
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CALL (External Subroutine Reference) 



Label Operation Field 

Optional CALL 

(* for indirect 
addressing is 
optional) 



Variable Field 

External Entry Point 

(,1 for indexing is 
optional) 



This statement generates object coding that has the same 
effect on the loader as a JST to the name specified in the 
variable field followed by an EXT statement that defines 
that name as external. For example, the statement CALL TST1 
generates object coding that is equivalent to the statements 



JST 
EXT 



TST1 
TST1 



The variable field must contain a single variable (not an 
expression) of up to 6 characters. 

Examples 





CALL 


SIN 


B3 


CALL 


F$IO 




CALL* 


TLIST 




CALL 


TABLE 6,1 




CALL* 


ARRAY , 1 
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SUBR, ENT (Define Entry Points) 

These pseudo-operations are identical in effect. They are 
used in external subroutines to link subroutine entry points 
to external names used in CALL, XAC, or EXT statements in 
main programs. Both mnemonics are provided for compatibility 
with other assemblers. The form is: 



Label Operation Field Variable Field 

Optional SUBR or ENT Extname 

or 
Extname, Entryname 

where Extname is the external name used in the main program, 
and Entryname is the name of the entry point in the subroutine, 
if different from Extname. 



Examples : 

Main 

Program CALL TST1 



External SUBR TST1 

Subroutine 



TST1 DAC ** 



JMP * TST1 
END 



This is a simple case where external name TST1 is linked by 
a SUBR statement to entry point TST1 of the external sub- 
routine. When the main program uses a different external 
name, the SUBR statement can equate names as follows: 
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Main CALL MAINT1 

Program 



External SUBR MAINT1,TST1 

Subroutine 



TST1 DAC ** 



JMP * TST1 
END 



The name MAINT1 is equated to the actual entry point TST1 by 
the SUBR statement. 

ENT statements have the same effect as SUBR statements but 
usually identify entry points or locations other than the 
main subroutine entry point. For example: 

Main CALL MAINT1,TST1 

Program 

LDA TST2 



JMP TST3 



EXT TST2 
EXT TST3 
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External 
Subroutine 



SUBR MAINT1,TST1 
ENT TST2 
ENT TST3 



TST1 DAC ** 



TST2 OCT '77 



TST3 LDA XYZ 



Here, the main program refers to two locations in the external 
subroutine, TST2 and TST3. The EXT statements in the main 
program notify the loader that the names are external. The 
ENT statements in the subroutine notify the loader that the 
subroutine contains those names. 

ENT statements also permit the main program to use different 
names from those used in the subroutine; for example, 



Main 
Program 



JMP 



TEST2 



EXT TEST2 



External 
Subroutine 



ENT TEST2,TST2 



TST2 LDA XYZ 
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As many SUBR or ENT statements may be used as are needed, and 
the statements may appear anywhere within the subroutine. 
However, only the object code following the pseudo-operation 
will be. loaded. Thus several subroutines can be packed in a 
single tape or file, and only the ones that are specified by 
SUBR or ENT statements will be loaded. 

Since the loader restricts external names to 6 characters 
maximum, only the first 6 characters of any name, in the 
variable field of the ENT or SUBR statement are used as the 
name internal to the main program. 
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CONDITIONAL ASSEMBLY PSEUDO OPERATIONS 



IF (Conditional Statement) 



Label 
Optional 



Operation Field 
IF 



Variable Field 

(Expression) (Statement) 
(Statement): (etc.) 



The variable field consists of an expression followed by one 
or more instruction or pseudo-operation statements separated 
by colons. If the expression is true (has a non-zero result) 
the rest of the line is assembled. Otherwise the rest of the 
line is ignored and the next line is processed. The variable 
field of the IF statement must not be continued into the 
following line, because the skip-if-false condition proceeds 
to the next physical rather than logical line. 

Examples : 



IF FLAG SET FLAG=0 ; GO TO A24 

IF (COUNT .LT. MAX) SET COUNT = COUNT + 1 

IF (CONTROL .EQ. 134) GO TO FIXC 

IF (N .NE. M) LDA N : AOA ; STA M 

IF (OPTION .AND. '01000 .EQ. 1) GO TO S130 
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IFM (Continue Assembly if Minus) 
IFP (Continue Assembly if PlusJ~ 
IFZ (Continue Assembly if Zero) 
IFN (Continue Assembly if Not Zero) 

This group of pseudo-operations is provided for compatibility 
with other assemblers. 

Label Operation Field Variable Field 

Optional IFM Expression 

IFP 
IFZ 
IFN 

The expression in the variable field is evaluated. If the 
result matches the IF condition, assembly proceeds normally. 
Otherwise, the assembler ignores all subsequent statements 
until an ENDC statement is reached. 

For every IFx statement there must be a matching ENDC statement 
IFx and ENDC pairs may be nested within each other. The 
nesting depth count is checked even in sections of code that 
are being skipped by a previous IFx statement. 

Examples : 

IFP B20 (continue assembly if B20 is > 0) 

IFM (1+3-24) (continue assembly if expression < 0) 

IFZ (ALPHA- 6) (continue assembly if expression = 0) 

IFN X24-1 (continue assembly if expression / 0) 
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ENDC (End Conditional Assembly Area) 

Label Operation Field Variable Field 
Not Used END C Not Used 

Defines the end of a conditional assembly area started by an 
IFP, IFM, IFZ, or IFN statement. Every IFx statement must 
have a matching ENDC. 



ELSE (Reverse Conditional Assembly) 

Label Operation Field Variable Field 
Not Used ELSE Not Used 

Reverses the condition set up by an IFx statement until the 
matching ENDC statement is reached. If the IFx condition 
inhibited assembly, the ELSE statement enables assembly, 
and vice versa. ELSE statements that lie within the bounds 
of other IFx-ENDC pairs nested within the conditional assembly 
area are ignored. 

Examples : 

OBOiS?::' * TEST OF ELSE <WITH OLD-STYLE IFS>. 

0306 SO 
< 8879 > 
'::8872> 
C0073> 
, ;0875; 1 
OIi877> 
':.087S::' 
•:'. Q8S8 > 
'.'! 88S2 > 
<. 8884 > 
C 8886 > 
01002: 82.88887 ■.'0087} 

•:: 8888 > ENDC 



■TEST 


OF ELSE 


IFF 


F I VE 


ELSE 




ENDC 




IFP 


MTWO 


ELSE 




ENDC 




I GP 


MTWO 


IFP 


F I VE 


ELSE 




ENDC 




ELSE 




LDFl 


I'" 
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FAIL (force Error Message) 

Label Operation Field Variable Field 
Optional FAIL Not used 

The assembler responds to a FAIL statement by printing the 
error message "F". This notifies the operator of a logical or 
range error, for example within the range of a conditional IFx 
statement, that has caused the assembly to proceed to an 
undesirable location. 



4-47 



SECTION 5 
MACRO FACILITY 



The macro feature of this assembler enables the programmer 
to define functions that can be expressed in easily- 
interpreted English (or other) language statements, such 
as: 



TRANSFER DATA TO DAC 

TTIRN ON VALVE 312 

Once a macro function has been defined, it can be called 
for use over and over again within a program. New argu- 
ment values (DATA, DAC, ON 312) can be provided with every 
call. Dummy words (TO, VALVE) can be used to increase 
intelligibility. Such words can be identified during 
macro definition so that they will not be treated as 
arguments when they appear in a macro call. 

After a set of macros has been defined by a system-level 
programmer, a specialist in a particular application field 
can formulate macro calls to solve his application problems, 
without becoming involved in the details of assembly 
language programming. 

Macros are defined by the MAC and ENDM pseudo-operations. 
These and other features of macro definition, listing, and 
assembly are discussed in detail in this section. 
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MACRO DEFINITIONS AND CALLS 



Two pseudo-operations are provided for macro definition: 
The MAC and ENDM statements. 



MAC (Begin Macro Definition) 



Label Field 

Name of macro 
(to be used 
in operation 
field of macro 
calls) 



Operation Field 

MAC 



Variable Field 

Optional dummy 
words and/or 
argument 
identifiers 
(see text) 
separated by 
commas . 



.A MAC statement begins the definition of a macro named 
by the label field. The name is formed in the same way 
as any variable or label. Following the MAC statement are 
the statements that make up the macro definition ; for 
example: "" " 

TRANSFER MAC 

LDA <1> 

STA <2> 

ENDM 

The integers enclosed in angle brackets are argument 
references . During assembly they are replaced by 
argument values specified in a macro call . Optional 
dummy words ("noise words") and argument identifiers 
("positional noise words") are described later. 

Macro definitions may contain macro calls to any depth, 
but macro definitions themselves cannot be nested. 
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ENDM (End Macro Definition) 

The macro definition must be concluded by an ENDM statement: 
Label Operation Field Variable Field 
Optional ENDM Ignored 

This statement terminates assembly of the macro. 

Argument References 

Argument references (in angle brackets) may be specified 
in any field of a statement within a macro definition. 
The number within the angle brackets may be a variable 
or an expression, provided all variables within the 
expression are previously defined as absolute integer 
values at the time the macro is called. 

Example: LDA <I> + <J-I+1> 

Argument references may be nested to any desired depth. 

Example: <I + <3 - <J>> -1> 

Arguments <1> and up are replaced by argument values from 
the variable field of a macro call during assembly. 

Argument <0> is replaced by the label field of the macro 
call during assembly. The label of the macro call is 
not automatically assigned. 

Example: <0> LDA <3> - 1 

Macro Calls 

A macro call is a special type of statement that uses 
the name of a defined macro in the operation field: 

Label Operation Field Variable Field 

Optional Name of User- Argument value 

Defined or expressions, plus 

Library Macro optional dummy 

words or argument 
identifiers , 
separated by commas 
or blanks 

For each macro call, the assembler enters the in-line code of 
the defined macro starting at the current location. Argument 
references are replaced by argument values from the variable 
field. 
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User-defined macros must be defined in source statements 
preceding the macro call. 

Here is a a typical call to the TRANSFER macro defined 
above: 

TRANSFER ARG1, '1770 

Argument' Values 

The variable field of a macro call usually contains one 
or more expressions to be interpreted as argument values. 
An argument value expression starts with the first non- 
space character of the variable field and continues until 
a terminating comma or space occurs. (The comma or space 
is not considered part of the argument expression.) 

Argument Substitution 

During assembly of a macro call, the assembler substitutes 
the argument values in the macro call variable field for 
the argument references in the macro definition. 
Argument expressions are matched to argument references 
in numerical order from left to right: 

Variable Field Argument < 1> Argument <2 > Argument <5 > 

A A 

A+3 A+3 

X,Y-1,Z*A-1 X Y-l Z*A-1 

X,B-C (Z3X2) X B-C Z3X2 

(A,B-1), C A,B-1 C 

(X,Y, (Z1+Z2) ,3} X,Y,Z1+Z2),3 



The first expression in the macro call is assigned as 
argument 1, the second as argument 2, and so on. In the 
following call to the TRANSFER macro - 

TRANSFER ARG1 , *177 

The variable ARG1 is argument 1 and the constant '1770 
is argument 2 . Thus, the macro example is assembled 
as : 

LDA ARG1 

STA '1770 

Arguments that are not assigned values in a macro call 
are set to zero by the assembler. 
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Argument Values in Parentheses 

Argument value expressions may be enclosed in parentheses 
to permit the use of commas, spaces, or string delimiters 
within a single argument. (The outside parentheses are 
not included as part of the argument expression.) One 
use of this is in forming sub-lists of arguments for 
macro calls nested within a given macro definition. 

Examples : 



MACRO 

DEFINITION 

CONTAINING. 

CALL TO 

"TRANSFER" 

MACRO 



WAIT 



MAC 

IRS <1> 

JMP * -1 
TRANSFER <2> 
ENDM 



CALL TO r 
WAIT MACRO-|_ 



WAIT 100, (ARG1, ARG2) 



ASSEMBLED 
AS 



IRS 100 
JMP * -1 
LDA ARG1 
STA ARG2 



Dummy Words 

An ordinary macro like: 

TRANSFER ARG1 , ARG2 

is simple, but cryptic. A few extra words in the variable 
field of the macro call can improve the intelligibility 
greatly as in: 

TRANSFER ARG1 TO ARG2 

TRANSFER DATA TO PRINTER 

TRANSFER MESSAGE TO TTY 

TRANSFER FROM CONSOLE TO DISPLAY 
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and so on. These macro calls are made self-documenting 
by a combination of meaningful argument symbols (DATA, 
MESSAGE, PRINTER etc.) plus "dummy" words, such as 
TO, FROM. Dummy words are ignored by the assembler 
(ie., not mistaken for argument symbols). 

Dummy words applicable to a given macro are assigned in 
the variable field of the MAC statement that starts the 
macro definition, as in: 

TRANSFER MAC TO 



ENDM 

In this statement, TO is defined as a dummy word. In any 
subsequent call to this macro, the assembler ignores the 
word TO (does not mistakenly assume it to be a symbol to 
be substituted for an argument) . All other expressions 
in the variable field are interpreted as arguments 
(proceeding in numerical argument order from left to 
right) and substituted for the argument numbers in the 
macro definition statements as usual. When TRANSFER 
macro is called by a statement 

TRANSFER ALPHA TO '7770 

the assembler ignores the TO and assembles the macro as 
if the call statement were TRANSFER ALPHA, '7770. 

A dummy word string can be any number of ASCII characters 
(letters, numerals, period and $ sign). Any number of 
dummy word strings may be used in a macro call, separated 
by commas. If the first character of a dummy word string 
is an open parenthesis, all characters (including spaces 
and commas) up to the closing parenthesis are considered 
part of the same string. (The surrounding parentheses are 
not included) . 

Here are some possible variations of the TRANSFER macro: 
MAC Statement Macro Call 

TRANSFER MAC DATA, FROM, TO TRANSFER DATA FROM ALPHA TO '7770 
TRANSFER MAC VOLTS, TO, DIG OUT TRANSFER 3.22 VOLTS TO DIG OUT 14 
TRANSFER MAC COUNTS, TO, PULSER TRANSFER 3374 COUNTS TO PULSER $FF 

Arguments are underlined. 
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Other examples o£ typical macro calls using dummy words: 
INPUT SI, Ml, S2, S3 AND M6 
ADJUST K2 BY K3 , T4 BY K3 AND T5 BY Tl 
MOVE 3 WORDS FROM X31 TO Z21 
SUM XI, X2, X3 AND X4 
DISPLAY ALPHA 
CONNECT 7.0 VOLTS TO PIN 5 ON CONNECTOR 1 

Argument Identifiers 

The self-documenting effect of dummy words improves the 
intelligibility of macro calls, but the programmer must be 
careful to enter values for arguments in the proper order. 
Argument identifiers increase the format flexibility of 
macro calls by associating a particular argument number 
with a specific dummy word, regardless of order. For 
example, identifiers can be defined so that argument 1 
follows the dummy word "TO", and argument 2 follows "FROM", 
regardless of the order in which TO and FROM appear in the 
macro call. 

Argument identifiers, like dummy words, are assigned in 
the variable field of a MAC statement that introduces a 
macro definition. An argument identifier word consists of 
a dummy word enclosed in parentheses and equated to an 
argument number: 

TRANSFER MAC (FROM) = 1, (TO) = 2 



ENDM 

When a call to the macro uses a defined argument identifier 
in its variable field, the first non-dummy expression 
immediately following the identifier is taken as the value 
of the argument: 

TRANSFER FROM ALPHA TO BETA 

TRANSFER TO BETA FROM ALPHA 

Both of these calls have the same effect: the expression 
following the dummy word FROM is taken as argument <1> , and 
the expression following TO is taken as argument <2> . 
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Argument identifiers and dummy words may be used together 
in the same macro. Ordinary dummy words are ignored, as 
usual . 

Arguments that are not associated with identifier words 
receive values in the usual positional priority - the 
first non-dummy word is taken as the value for the first 
unspecified argument, and so on. Example: 

Macro 

Definition: MASK MAC (BY) =2, (TO) =3, MASK, TRANSFER, AND 

LDA <1> 

ANA <2> 

STA <3> 

ENDM 

Macro 

Call: MASK INPUT BY =7 AND TRANSFER TO BUFFI 

Here, argument 2 is =7 and argument 3 is BUFFI, as 
located by identifier words BY and TO. Argument 1 is 
assigned the value of the expression INPUT (the only other 
non-dummy word in the variable field) . 

Assembler Attribute References 

Certain useful attributes of a macro can be specified by a 
number preceded by the pound character (#) . The following 
assembler attributes are presently available to the macro 
programmer: 

#1 = Current Macro Call Number. 

#2 = Number of Arguments in Current Macro Call. 

(others may be assigned later) 

The attribute number may be a variable, or an expression 
within parentheses, as long as such variables are previously 
defined as absolute integer values. Attribute references 
are evaluated as absolute integer values. 

Examples: #3 

#XYZ 
#(1*2) 
# <3> 
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Local References Within Macros 

Local labels can be assigned within a macro definition by 
using the ampersand character (§) as the first character 
of the label. Local labels do not conflict with labels 
outside of the macro. The ampersand is replaced by a 
4-digit macro call number, thereby assuring uniqueness of 
the label regardless of the macro's environment. Use of 
the "V outside of a macro will result in the substitution 
of 4 zeros. 

Examples : Local Label Evaluated As In Macro Call 

§ABC 0002ABC 0002 

§X3A 1739X3A 1739 
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MACRO LISTING AND ASSEMBLY CONTROL 

Three levels of listing detail for macro calls are provided. 
The default condition is NLSM, which causes only the Macro 
call statement to be processed (no detailed output) . These 
pseudo-ops are global in that they remain in effect until 
a new macro listing control pseudo-op is specified. 

The BACK (TO) and SAY statements control assembly of macros. 

LSTM (List Macro Expansions) 

Label Operation Field Variable Field 

Optional LSTM Not used 

Directs assembler to list macro call statements and all 
lines generated by expansion of the macro, including code 
or data values. 

Example: 







'■. 0001 > 


*TRflN 


SFE> 


'• MRC 


RO 


EXAMPLE 






'■'Q002> 


■¥ 














i; 0007. :> 






LSTM 








001000 


t 0^04 .:< 


STRPT 




0RG 




'" 1000 






aiflfl! 1 ' > 


TRRNS 


FER 


I'lRC 




TO 






(0006':' 






L.DR 




<1> 






O3007> 






OTR 




"'■- ti*. ..•"" 






O300O,' 1 






ENDi'1 






91. 000 : 


0,1 9100 : ' 


<■:. ML..01 > 






LDR 




DRTfl 


0:1 00:1 : 


171777 


aiUM. ■' 






OTR 




DRC 


'1.002 ' 


000047 


(0010 > 


DRTR 




DEC 




~>3 




001777 


C 081.1 ':> 


DRC 




SET 




1 r' ('' r' 




091.007 


'■. 001.2 "} 






END 
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LSMD CList Macro Expansions - Data Only) 

Label Operation Field Variable Field 

Not used LSMD Not used 

only those 

Directs assembler to list macro calls plus any lines 
generated in the expansion of the macro that generate 
data. 
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NLSM (No Listing Of Macro Expansions) 

Label Operation Field Variable Field 

Not used NLSM Not used 

Inhibits listing of statements generated by the assembler 
during macro expansion. Only the macro call is listed. 
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BACK, BACK TO (Loop Back - Macros Only) 

Label Operation Field Variable Field 

Optional BACK 

or Statement label 

BACK TO 

This statement directs the assembler to repeat source 
statements that have already been assembled, beginning 
with the statement specified in the variable field. Such 
backward references are permitted only within a macro 
prototype. (Both the BACK, BACK TO and the specified 
statement label must lie between the same MAC statement 
and its corresponding ENDM) . 

Examples : 

BACK TO AB16 

BACK AB16 

IF (X .NE. 0) BACK TO START+3 

SAY (List Message to Operator) 

Label Operation Field Variable Field 

Optional SAY Any ASCII text string 

The assembler responds to a SAY statement by printing the 
content of the variable field, starting at column 1 of the 
listing. Usually, the SAY statement is used within a macro 
to generate error comments or other messages to the 
operator. Macro argument references (enclosed by angle 
brackets) are replaced by their equivalent character string 
before output. 

SAY statements generate output regardless of the setting of 
the listing options, as long as a listing device is assigned. 
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Macro Definition: 



(0351 ) 
(0352) 
(0353) 
( 035H ) 

(03b5) 
(03^6) 
(03W7) 
(SI3!i>«) 
(0359) 
(0360) 
(0361 ) 
(03E-2) 
(&363) 
(0364) 



OLOMAC 
NLST 
SAY 
SAY 
SAY 
',AY 



MAC USING, AND 



SAY 

hAY 

cAY 

SAY 

SAY 

LIST 

ENDM 



************************************************* 

OLD MACDONALO HAD A FARM, E-»-E~I-0. 

AND ON THIS FARM HE HAD SOME <1>, E-I-E-I-O. 

WITH A <2> <2> HERE AND A <2> <2> THERE, 

HERE A <2>, THERE A <2>, 

EVERYWHERE A <2> <2>, 

OLD MACDONALD HAD A FARM, E-I-E-I-O. 
************************************************* 



Macro Calls: 



(0365) OLOMAC, USING CHICKS AND CHEEP 



********************************* ************************** 

OLD MACDONALO HAD A FARM, E-I-E-I-O. 

AND ON THIS FARM H£ HAD SOME CHICKS, E-I-E-I-O. 

WITH A C«-'EEP CHF.FP HERE AND A CHFEP CHEEP THERE, 

HERE A CHEEP, THERE A ChEEP, 

EVERYWHERE A CHEl-P CHEEP, 
OLD-MACDONALD HAD A FARM, E-I-E-I-O. 
************************************ *********************** 

(0366) OLDMAC, USING DUCKS AND QUACK 

*********************************************************** 

OLD MACDONALO HAD A FARM, E-I-E-I-O. 

AND ON THIS FARM HE H*D SOME DUCKS, E-I-E-l-O. 

WITH A QUACK QUACK HrIRE AND A QUACK QUACK THERE, 

HERE A (JUACK, THERE A QUACK, 

EVERYWHERE A QUACK QUACK, 

OLD MACDONALO HAD A FARM, E-I-E-I-O. 

*************,******** + ***** ********************************* * 

(0369) OLOMAC, USING NEWLYWEDS AND CBEEP] 

*************** ****************** ************************** 

OLD MACDONALO HAD A FARM, E-I-E-I-O. . 

AND OM THIS FARM HE H<\0 SOME NEWLYWEDS, E-I-E-l-O. 

WITH A [bF.FPD CHEEP] HERE AND A C3EEP3 CBEEP3 THERE, 

her;; a LbEiv], the he a c beep 3, 

EVERYWHERE. A .CHEEP] CBEEP 3, 
OLD MACDONALO HAD A FARM, E-I-E-I-O. 
*********************************************************** 
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MACRO EXAMPLES 



The following macro example makes use of local symbols, 
assembly attributes, and looping. The number of arguments 
processed by this macro is variable. 

Definition: 

ADJUST MAC BY, AND 

SET SN = 1 

§L1 IF ($N .CT. #2) CO TO $L2 

LDA (P T N) ARC. #1, 3, 5, ETC. 

MPY (SN+1) ARC. #2, 4, 6, ETC. 

STA (§N) 

SET $N = f 7 N + 2 

BACK TO +L1 

$L2 EBDN 

Macro Calls: ADJUST A3 BY 16, A4 BY 20 AND A5 BY 3 

ADJUST METER1 BY 100 
ADJUST XI, 2 X2,2 X3,2 X4,50 X5,50 X6,2 



Definition: 



MOVE MAC WORD, WORDS, FROM, TO 

IF (<1> .EO. 1) LDA <2>: STA <3>: GO TO $X 

LDX = <1> 

LDA <2> -1,1 

STA <3> -1,1 

DXS 1,1 

JMP * - 5 
§X ENDM 
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Macro Calls: MOVE 1, ALPHA, BETA 

MOVE 20, LIST, TABLE 

MOVE 1 WORD FROM ALPHA TO BETA 

MOVE 20 WORDS FROM LIST TO TABLE 

MOVE 3, FROM X31 to Z21 

The following macro does not generate any coding, just an 
answer. It demonstrates how macros can be used to 
construct interpreters as well as compilers. 

Definition: 

FACTORIAL MAC OF 

FACTA <1> ,1 

ENDM 
* 



FACTA 



MAC 

IF (<1> .EO. 0) DATA <2> 

SET A2 = <1> * <2>, Al = <1> - 1 

IF «2> .NE. 0) FACTA Al ,A2 
ENDM 



Macro Calls 



FACTORIAL OF 5 
FACTORIAL 7 
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The following example shows the type of "language" that 
can be provided for business applications when a suitable 
set of macros are prepared in advance. (The macro defini 
tions are not shown.) 



* FILE AND FIELD DEFINITION. 

INPUTREC FILE CONTAINS 80 WORDS FROM UNIT 5 

OUTPUTREC FILE CONTAINS 80 WORDS ON UNIT 6 

AMOUNT FIELD OF INPUTREC FROM COLUMNS 25 TO 20, @ DECIMAL 
POSITIONS 

CODE FIELD OF INPUTREC FROM COLUMNS 25 TO 30 

NAME FIELD OF INPUTREC FROM COLUMNS 65 TO 7 5 

NAMEOUT FIRLF OF OUTPUTREC FROM COLUMNS 1 TO 10 

CODEOUT FIELD OF OUTPUTREC FROM COLUMNS 11 TO 16 

AMOUNTOUT FIELD OF OUTPUTREC FROM COLUMNS 17 TO 23, 
2 DECIMAL POSITIONS 

* START EDITING PHASE OF PROGRAM. 

START READ INPUTREC, IF END OF FILE, GO TO EOF 

MOVE AMOUNT TO AMOUNTOUT 

MOVE CODE TO CODEOUT 

MOVE NAME TO NAMEOUT 

WRITE OUTPUTREC 

TO TO START 
* 

* --FILE PROCESSING COMPLETE. 

EOF END 
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SECTION 6 
SOURCE FILE MERGING COMMANDS 

The assembler includes a function called RDALN (read 
alternate lines) that has the ability to merge lines from 
two or more source files during assembly. File merging is 
controlled by special command statements in the primary 
source file that begin with a dollar sign: 

$ INSERT 
$UPDATE 
$COPY 
$DONE 

The primary source file is the file (or device) specified 
in the usual manner at the start of assembly. Secondary 
files stored on disk or mounted on a specific input-gutput 
device are selected by a filename or device code specified 
in the variable field of a $ INSERT or $UPDATE command. 

Only disk-resident files can be identified by filename. When 
non-disk devices are used, a device code is used instead 
of a filename: 

(A) ASR (P) PTR (C) CARDS 

(M) MAG TAPE (K) Cassette 

The parentheses must be included in device codes. Only the 
first character is needed to identify the device; other 
characters may be included for documentation (as in ASR or 
PAPER TAPE READER) but the extra characters are ignored. 

File merging commands are allowed in the primary source file 
only, not in secondary files. 

$ INSERT 

Label Operation Field Variable Field 
Optional $ INSERT Filename or device code 

When the assembler reaches an $ INSERT command in the primary 
source file, it opens the specified file (or starts the device) 
and starts reading statements from the secondary file. The 
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secondary file is read in entirety, up to but not including 
the end-of-file mark. The assembler then returns to the 
primary file and resumes at the line following the $INSERT 
command. Nesting of $INSERT commands is not allowed. 



$ UPDATE 

Label Operation Field . Variable Field 
Optional $UPDATE Filename or device code 

When the assembler reaches an $UPDATE command in the primary 
source file, it opens the named file (or starts the device) 
but continues reading from the primary source file until a 
$COPY command is found in the primary file. 

If the primary file contains more than one $UPDATE command, 
the one most recently processed determines the secondary 
file to be accessed by $COPY commands. 



$COPY 



Label Operation Field Variable Field 
Optional $COPY m,n 



When a $COPY command is found in a primary source file, lines 
m through n of the secondary file specified by the most 
recent $UPDATE command are input to the assembler. After 
line n has been processed, the assembler returns to the 
primary file and processes the record following the $COPY 
command . 

$COPY commands may also be entered in the following forms: 



$COPY m 
$COPY ,n 



Copy line m of secondary 
file only 

Copy from current position 
in secondary file up to and 
including line n 
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$DONE 

Label Operation Field Variable Field 
Optional $DONE Not used 

Upon reaching a $DONE statement, the assembler closes all 
open files and shuts down all devices used for secondary 
input. 
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APPENDICES 

A PRIME 200 Instructions (Op Code Order) A-l 

B PRIME 200 Instructions (Class Order) B-l 

C PRIME 200 Instructions (Mnemonic Order) C-l 

D I/O Device Codes D_1 

E ASCII Character Codes E" 1 

F Object File Formats F_1 

G Assembler Error Messages 6-1 



APPENDIX A 
PRIME 200 INSTRUCTIONS 
(OP CODE ORDER) 



G 

G 
G 
G 
G 
G 

Q 
G 
G 
G 

G 
G 
G 
G 
G 
G 
G 
G 
G 
G 
G 
G 
G 
G 
G 
G 
G 

MR 
MR 
MR 
MR 
MR 
MR 
SH 
SH 
SH 
SH 
SH 
SH 
SH 
SH 
SH 



080800 

880881 

088005 
080007 

808011 
880811!: 

000821 

000841 
888843 
880101 

000111 

088281 

888285 

880211 

000211** 

008481 

888485 

888411 

088415 

888417 

800501 

880503 

080505 

008511 
888515 

001081 

801013: 

01 



02 

02 

03: 

04 

84 

0488NN 

04 ©INN 

0402NN 

8404NN 

0405NN 

04 86NN 

0410NN 

0411NN 

0412NN 



* 



HL.T 
NOP 
SGL 
DBL 

Eies < d:«:a > 
e32s<:e:«:r> 

RMC <RMP> 

SCA 

INK 

NRM 

CEfl 

IflB 

PIM 

PID 

VI RV 

ENB 

DTK 

Cfll 

ESIM 

EVIM 

I....MCM 

EMCM 

ISI 
OS I 

INH 
E32R 

JMP 

DLD 

LDR 

RNR 

DST 

STR 

LRL. 

LRS 

LRR 

RRL <LGR> 

RRS 

RRR 

LLL 

LLS 

L.I...R 



MODE 
MODE 



TO fi 



HALT 

NO OPERATION 

ENTER SINGLE PRECISION MODE 

ENTER DOUBLE PRECISION MODE 

ENTER 16K SECTOR ADDRESSING 

ENTER 32K SECTOR ADDRESSING 

RESET MACHINE CHECK 

TRANSFER SHIFT COUNTER TO A 

TRANSFER <INPUT> STATUS KEVS 

NORMALIZE 

COMPUTE EFFECTIVE ADDRESS 

INTERCHANGE A AND B 

POSITION FOR INTEGER MULTIPLY 

POSITION FOR INTEGER DIVIDE 

VERIFV 

ENABLE INTERRUPT 

TRANSFER >:! OUTPUT > A TO STATUS KEV'5 

CLEAR ACTIVE INTERRUPT 

ENTER STANDARD INTERRUPT MODE 

ENTER VECTORED INTERRUPT MODE 

LEAVE MACHINE CHECK MODE 

ENTER MACHINE CHECK NODE 

SUPERVISOR CALL 

INPUT SERIAL INTERFACE TO A 

OUTPUT SERIAL INTERFACE FROM fl 

INHIBIT INTERRUPT 

ENTER 32K RELATIVE ADDRESSING HOf-f 

UNCOND I T I ON AL JUMP 

DOUBLE PRECISION LORD 

LOAD A 

AND TO A 

DOUBLE PRECISION bTORF 

STORE A 

LONG RIGHT LOGICAL 

LONG RIGHT SHIFT 

LONG RIGHT ROTATE 

A RIGHT LOGICAL 

A RIGHT SHIFT 

A RIGHT ROTATE 

LONG LEFT LOGICAL 

LONG LEFT SHIFT 

LONG LEFT ROTATE 



A-l 



SH 

sh 
sh 

MR 

MR 

MR 

MR 

MR 

MR 

G 

R 

G 

G 

G 

G 

G 

BR 

BR 

G 

G 

G 

G 

G 

G 

G 

BR 

BR 

G 

MR 

MR 

MR 

1 

G 

l.i 

G 

G 
G 
G 
G 
G 
G 
G 
G 
l.i 
G 
G 
G 
G 
G 
G 
G 
G 



0414NN 
0415NN 
0416NN 
05 

06 + : 
06 

07 + 
07 

1.0 

108800 

180801 

188826 

1.80848 

188188 

188288 

1.86228 

188248+N 

188268+N 

108400 

101001 

101036 

181840 

1.01188 

181288 

181228 

181240+N 

101268+ N 

1.81488 

11 

1.2 

13 

1.4 

148810 

140014 

140824 

148848 

1.48188 

1.48184 

148110 

148114 

148288 

148284 

14 8218 

148214 

1403Q4 

148318 

148328 

148481 

140487 

140410 

140411 

140412 



FILL 
flLS 
BLR 
ERR 
DAD 
ADD 
DSB 
SUB 
J ST 
SKP 
SRC 
SSR 
SZE 



:lgl 



>■. SEQ > 



slt: 



SMCR < SPN > 

SGT 

SRN 

SHP.H 

SPI... < SGE ;■ 

ssc 

SNZ <SNE> 
SI. N 

smcs>::sps> 

SI..E 

SSN 

SRSN 

SMI 

CflS 

IRS 

IMP 

OCP 

CRL 

CRB 

CHS 

CRfl 

SSP 

XCR 

SOA 

IRX 

RGB 

XCB 

DRX 

CAZ 

fl2fl 

S2A 

CSfl 

CMR 

TCP 

LLT 

LIE 

LNE 



510 > 



R LEFT LOGICAL 

R LEFT SHIFT 

R LEFT ROTATE 

EXCLUSIVE OR TO fl 

DOUBLE PRECISION ODD 

ADD MEMORY TO fl 

DOUBLE PRECISION SUBTRACT 

SUBTRACT MEMORY FROM A 

..TUMP TO EA + 1 AND STORE P 

UNCONDITIONAL SKIP 



IN EA 



SKIP 
SKIP 
SKIP 
SK I P 
SK I P 
SKIP 
SK I P 
SKIP 
SKIP 
SKIP 
SKIP 
SKIP 
SKIP 
SKIP 
SKIP 
SKIP 
SKIP 
SKIP 



ON 
ON 
ON 
ON 
ON 
ON 
ON 
ON 
ON 
ON 
ON 
ON 
ON 
ON 
ON 
ON 
ON 
ON 



1-4 SET 



TO ZERO 



C-BIT RESET 

NONE OF SENSE SWITCHES 1-4 

A ZERO 

A BIT 16 ZERO 

MACHINE CHECK RESET 

fl GREATER THAN ZERO 

SENSE SWITCH N RESET 

A BIT N RESET 

A PLUS 

C-BIT SET 

ANY OF SENSE SWITCHES 

A NOT ZERO 

A BIT 16 ONE 

MACHINE CHECK SET 

A LESS THAN OR EQUAL 

SENSE SWITCH N SET 

A BIT N SET 

A MINUS 
COMPARE A WITH MEMORY 
INCREMENT, REPLACE MEMORY AND SKIP 
INTERCHANGE MEMORY AND A 
OUTPUT CONTROL PULSE 
CLEAR LONG CA AND B> 
CLEAR B 

CHANGE SIGN OF A 
CLEAR A 

SET SIGN OF A PLUS 
TRANSFER A TO B AND CLEAR fl 
SUBTRACT ONE FROM R 
INCREMENT, REPLACE INDEX AND 
RESET C-BIT 

TRANSFER B TO A AND CLEAR B 
DECREMENT REPLACE INDEX AND 
COMPARE R WITH ZERO 
ADD TWO TO R 
SUBTRACT TWO FROM fl 
COPY SIGN TO C-BIT, 
COMPLEMENT R 
TWO'S COMPLEMENT A 
CONVERT fl<0 TO TRUE 
CONVERT ROO TO TRUE 
CONVERT •'-;fl=0:.-' TO TRUE 



JET 



SKIP 



SKIP 



SET SIGN OF fl PLUS 
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149413 


LEG! 


G 


149414 


LGE 


G 


140415 


LOT 


G 


14050© 


ssm 


G 


140600 


SCB 


G 


141044 


CAR 


G 


141050 


CAL 


G 


141140 


I CI... 


G 


141206 


flOR 


G 


141216 


RCH 


G 


141240 


I CR 


G 


141340 


I CR 


MR 


15 


LDX 


MR 


15 


SIX 


MR 


16 


MPV 


MR 


17 


DIV 


10 


34 


SKS 


10 


54 


INfl 


10 


74 


OTR 


1 


74 


SMK 



CONVERT R=0 TO TRUE 
CONVERT R>=0 TO TRUE 
CONVERT R>0 TO TRUE 
SET SIGN OF R MINUS 
SET C-BIT 

CLEAR RIGHT BVTE OF R 
CLEAR LEFT BVTE OF R 

INTERCHANGE BVTES OF R AND CLEAR LEFT BVTE 
<R1R> ADD ONE TO R 

RDD C-BIT TO R 

INTERCHANGE BVTES OF R 

INTERCHANGE BVTES OF R 

LOAD INDEX < ASSEMBLER ': 

STORE INDEX < ASSEMBLER 

MULTIPLV 

DIVIDE 

SKIP IF SET 

INPUT TO A 

OUTPUT FROM A 

SET INTERRUPT MASK 



AND CLEAR RIGHT BVTE 

SETS INDEX BIT* 
CLEARS INDEX BIT.) 
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APPENDIX B 



PRIME 200 INSTRUCTIONS 



(CLASS ORDER) 



BR 

BR 

BR 

BR 

G 

G 



G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 

G 



100248+ N 
100260+N 
101240+N 
101260+N 

000000 

000001 

000005 

£100007 

000011 

000013 

000021 

000041 

000043 

000101 

000111 

000201 

000205 

000211 

000311** 

000401 

000405 

000411 

000415 
000417 

000501 

080503 
000505 
008511 
080515 

001001 
001013 
108000 
100081 

100836 

100040 
100188 
100200 

100228 

100480 
101801 

101036 
101048 

101180 
101200 



SRN 

SRRN 

SSN 

SASN 

HLT 

NOP 

SGL 

DBL 

E16SCDXR> 

E32S<EXfl> 

RMC <RMP> 

SCR 

INK 

NRM 

CEA 

IBB 

PIM 

PID 

VIRV 

ENB 

DTK 

CHI 

ESIM 

EVIM 

I....MCM 

EMCM 

ISI 
OS I 
INH 

E32R 

SKP 

SRC 

SSR 

SZE <!SEQ> 

SLZ 

SMCR<SPN> 

SGT 

SPL -:sge> 

SSC 

sss 

SNZ <SNE> 

SLN 

SMCSCSPS) 



SWITCH N 
N RESET 
SWITCH N 
N SET 



SKIP ON SENSE 

SKIP ON R BIT 

SKIP ON SENSE 

SKIP ON fl BIT 

HRLT 

NO OPERATION 

ENTER SINGLE PRECISION 

ENTER DOUBLE PRECISION 

ENTER 16K SECTOR ADDRE5 

ENTER 32K SECTOR RDDRE'J 

RESET MACHINE CHECK 

TRANSFER SHIFT COUNTER 



RESET 



SET 



MODE 
MODE 

;sing 
;sing 

TO A 



MODE 
MODE 



TRANSFER C INPUT J' STATUS KEYS TO A 

NORMAL.. I ZE 

COMPUTE EFFECTIVE ADDRESS 

INTERCHANGE A AND B 

POSITION FOR INTEGER MULTIPLY 

POSITION FOR INTEGER DIVIDE 

VERIFY 

ENABLE INTERRUPT 

TRANSFER < OUTPUT > A TO STATUS KEYS 

CLEAR ACTIVE INTERRUPT 

ENTER STANDARD INTERRUPT MODE 

ENTER VECTORED INTERRUPT MODE 

LEAVE MACHINE CHECK MODE 

ENTER MACHINE CHECK MODE 

SUPERVISOR CALL 

INPUT SERIAL INTERFACE TO A 

OUTPUT SERIAL INTERFACE FROM A 

INHIBIT INTERRUPT 

ENTER 32K RELATIVE ADDRESSING MODE 

UNCOND I T I ONRL SK I P 

SKIP ON C-BIT RESET 

SKIP ON NONE OF SENSE SWITCHES 1-4 SET 

SKIP ON A ZERO 

SKIP ON R BIT 16 ZERO 

SKIP ON MACHINE CHECK RESET 

SKIP ON A GREATER THAN ZERO 

SKIP ON A PLUS 

SKIP ON C-BIT SET 

SKIP ON ANY OF SENSE SWITCHES 1-4 SET 

SKIP ON A NOT ZERO 

SKIP ON A BIT 16 ONE 

SKIP ON MACHINE CHECK SET 



B-l 



G 


101220 


SLE 


G 


1.01400 


SMI 


G 


140010 


CRL 


G 


140014 


CRB 


Li 


140024 


CHS 


G 


140040 


CRR 


G 


140100 


SSP 


G 


140104 


XCR 


G 


140110 


SOfl 


G 


140114 


T.RX 


G 


14 0200 


RGB 


G 


140204 


XCB 


G 


14Q210 


DRX 


G 


.1.40214 


CfiZ 


G 


140304 


R2R 


G 


140310 


S2A 


G 


140320 


CSA 


G 


140491 


CMR 


G 


140407 


TCR 


G 


140410 


LIT 


G 


140411 


LLF 


G 


140412 


LNE 


G 


1 40413 


LEG 


i..i 


140414 


LGF 


G 


140415 


LOT 


i * 


140500 


SSM 


G 


140600 


SCB 


G 


141044 


COR 


G 


141050 


CRL 


G 


141140 


ICL 


G 


141206 


ROR 


G 


141216 


RCR 


G 


141240 


TCR 


Li 


141340 


ICR 


1 


1.4 


OCR 


TO 


34 


SKS 


10 


54 


I MR 


TO 


74 


OTR 


10 


74 


SMK 


MR 


01 


JMP 


MR 


02 * 


DLD 


MR 


02 


LDfl 


MR 


03 


RNA 


MR 


04 :+: 


DST 


MR 


64 


STfl 


MR 


05 


ERR 


MR 


06 * 


DRD 


MR 


06 


ADD 


MR 


07 * 


DSB 


MR 


07 


SUB 


MR 


10 


■J ST 


MR 


11 


CflS 


MR 


12 


IRS 



SKIP ON R LESS THAN OR EQUAL TO ZERO 
<SLT> SKIP ON A MINUS 

CLEAR LONG -.'A AND B> 

CLEAR B 

CHANGE SIGN OF A 

CLEAR A 

SET SIGN OF fl PLUS 

TRANSFER A TO B AND CLEAR A 
■::S1R..' SUBTRACT ONE FROM A 

INCREMENT, REPLACE INDEX AND SKIP 

RESET C-BIT 

TRANSFER B TO R AND CLEAR B 

DECREMENT REPLACE INDEX AND SKIP 

COMPARE R WITH ZERO 

ADD TWO TO R 

SUBTRACT TWO FROM A 

COPY SIGN TO C-BIT, SET SIGN OF A PLUS 

COMPLEMENT R 

TWO'S COMPLEMENT A 

CONVERT fi<0 TO TRUE 

CONVERT ROO TO TRUE 

CONVERT " >::fl-0::> TO TRUE 

CONVERT A=0 TO TRUE 

CONVERT fl>=0 TO TRUE 

CONVERT A>0 TO TRUE 

SET SIGN OF R MINUS 

SET C-BIT 

CLEAR RIGHT BVTE OF A 
CLEAR LEFT BVTE OF A 

INTERCHANGE BYTES OF A AND CLEAR LEFT BVTE 
CA1A> ADD ONE TO A 

ADD C-BIT TO R 

INTERCHANGE BVTES OF A 

INTERCHANGE BVTES OF A 

OUTPUT CONTROL PULSE 

SKIP IF SET 

INPUT TO A 

OUTPUT FROM A 

SET INTERRUPT MASK 

UNCOND I T I ON AL JUMP 

DOUBLE PRECISION LOAD 

LOAD A 

AND TO A 

DOUBLE PRECISION STORE 

STORE A 

EXCLUSIVE OR TO A 

DOUBLE PRECISION ADD 

ADD MEMORY TO A 

DOUBLE PRECISION SUBTRACT 

SUBTRACT MEMORY FROM A 

JUMP TO EA + 1 AND STORE P IN FA 

COMPARE A WITH MEMORY 

INCREMENT, REPLACE MEMORY AND SKIP 



AND CLEAR RIGHT BYTE 
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MR 


13 


IMF) 


MR 


15 


LDX 


MR 


15 


STX 


MR 


16 


MPV 


MR 


17 


D I V 


SH 


0488NN 


L..RI. 


SH 


0401NN 


LRS 


SH 


0482NN 


I...RR 


sh 


0404NN 


RRL 


SH 


0405NN 


RRS 


SH 


0486NN 


RRR 


SH 


0410NN 


LLL 


SH 


0411NN 


I...LS 


SH 


0412NN 


LLP. 


SH 


0414NM 


fll.L 


SH 


0415NN 


RI...S 


SH 


0416NN 


RI..R 



INTERCHANGE MEMORY AND R 

LORD INDEX < ASSEMBLER SETS INDEX BIT::. 

STORE INDEX ''ASSEMBLER CLEARS INDEX BIT> 

MULTIPLY 

DIVIDE 

LONG RIGHT LOGICAL 

LONG RIGHT SHIFT 

LONG RIGHT ROTATE 
•:LGR> A RIGHT LOGICAL 

A RIGHT SHIFT 

A RIGHT ROTATE 

LONG LEFT LOGICAL 

LONG LEFT SHIFT 

LONG LEFT ROTATE 
■:l GL> A LEFT LOGICAL 

R LEFT SHIFT 

R LEFT ROTRTE 
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APPENDIX C 

PRIME 200 INSTRUCTIONS 

(MNEMONIC ORDER) 



G 


14 0304 


A2A 


G 


1.41216 


RCfl 


MR 


06 


HDD 


SH 


0414NN 


fill <LGL> 


SH 


0416NN 


ALR 


SH 


04 15NN 


fll.S 


MR 


03 


ANA 


G 


141206 


HOR tflifl> 


SH 


04 04NN 


RRL CLGR> 


SH 


0406NN 


RRR 


SH 


04Q5NN 


RRS 


G 


000411 


CRT 


G 


141050 


CAL 


G 


141044 


CRR 


MR 


11 


CAS 


G 


140214 


CRZ 


G 


000111 


CER 


G 


140024 


CHS 


G 


1404G1 


CMR 


G 


140040 


CRR 


G 


140014 


CRB 


G 


140010 


CRL 


G 


140320 


CSR 


MR 


06 + 


DflD 


G 


000007 


DBL 


MR 


17 


DIV 


MR 


02 + 


DLD 


G 


1 40210 


DRX 


MR 


07 * 


DSB 


MR 


04 * 


DST 


G 


000011 


E16S-:DXfl; 


G 


001013 


E32R 


G 


000013 


E32S'::EXR: 


G 


000503 


EMCM 


G 


000401 


ENB 


MR 


05 


ERR 


G 


000415 


ESIM 


G 


000417 


EVIM 


G 


000000 


HIT 


G 


000201 


IRB 


G 


141340 


ICR 


G 


141140 


ICL 


G 


141240 


I CR 



RDD TWO TO R 

HDD C-BIT TO R 

RDD MEMORV TO R 

R LEFT LOGICAL 

R LEFT ROTATE 

R LEFT SHIFT 

RND TO R 

ADD ONE TO fl 

fl RIGHT LOGICAL 

A RIGHT ROTATE 

A RIGHT SHIFT 

CLEAR ACTIVE INTERRUPT 

CLEAR LEFT BYTE OF A 

CLEAR RIGHT BYTE OF A 

COMPARE A WITH MEMORV 

COMPARE A WITH ZERO 

COMPUTE EFFECTIVE ADDRESS 

CHANGE SIGN OF fl 

COMPLEMENT R 

CLEAR A 

CLEAR B 

CLEAR LONG <f\ AND B> 

COPY SIGN TO C-BIT, SET SIGN OF A PLUS 

DOUBLE PRECISION ADD 

ENTER DOUBLE PRECISION MODE 

DIVIDE 

DOUBLE PRECISION LOAD 

DECREMENT REPLACE INDEX AND SKIP 

DOUBLE PRECISION SUBTRACT 

DOUBLE PRECISION STORE 

ENTER 1SK SECTOR ADDRESSING MODE 

ENTER 32K RELATIVE ADDRESSING MODE 

ENTER 32K SECTOR ADDRESSING MODE 

ENTER MACHINE CHECK MODE 

ENABLE INTERRUPT 

EXCLUSIVE OR TO A 

FNTER STANDARD INTERRUPT MODE 

ENTER VECTORED INTERRUPT MODE 

HALT 

INTERCHANGE A AND B 

INTERCHANGE BYTES OF A 

INTERCHANGE BYTES OF A AND CLEAR LEFT BVTfc 

INTERCHANGE BYTES OF A AND CLEAR RIGHT BVTi 



C-l 



MR 


13 


IMfl 




JO 


54 


INfl 




G 


001 081 


INH 




G 


060043 


INK 




MR 


12 


IRS 




G 


140114 


IRX 




G 


000511 


IS I 




MR 


01 


..IMP 




MR 


10 


■JST 




MR 


02 


IDA 




MR 


15 


LDX 




G 


140413 


LEO 




G 


14G414 


I...GE 




G 


140415 


LGT 




G 


140411 


LL..E 




SH 


8410NN 


ILL 




SH 


0412NN 


I....LR 




sh 


041 INN 


LI. S 




G 


140410 


LI....T 




G 


000501 


1 MOM 




G 


140412 


LNE 




SH 


0400NN 


LRL 




C .H 


0482NN 


I..RR 




SH 


04G1NN 


LRS 




MR 


16 


MPV 




G 


000081 


NOP 




G 


000101 


NRM 




J ( I 


14 


OOP 




G 


000515 


OS I 




TO 


74 


OTfl 




G 


000405 


OTK 




G 


800211 


P I D 




G 


080205 


PIN 




G 


148200 


RGB 




G 


800021 


RMC ■ 


; RMP :■ 


G 


148310 


S2R 




BR 


100260+N 


SARN 




BR 


181268+N 


SASN 




G 


800041 


SCR 




G 


140600 


SCB 




G 


000005 


SGL 




G 


100228 


SOT 




G 


180000 


SKP 




in 


34 


SKS 




G 


101220 


SLE 




G 


101100 


SLN 




G 


100100 


SLZ 




G 


100208 


SMCR< 


SPN> 


G 


181288 


SMCSC 


sps:> 


G 


101400 


SMI < 


SLT > 


10 


74 


SMK 




G 


101848 


SNZ < 


SNE> 


G 


14 8118 


SOR < 


S1A> 


G 


188480 


SPL < 


SGE > 


G 


188881 


SRC 




BR 


188248+N 


SRN 





INTERCHRNGE MEMORY AND R 

INPUT TO R 

INHIBIT INTERRUPT 

TRANSFER C INPUT? STATUS KEVS TO A 

INCREMENT, REPLACE MEMORV AND SKIP 

INCREMENT, REPLACE INDEX AND SKIP 

INPUT SERIAL INTERFACE TO A 

I. INCOND I T I ONAL JUMP 

JUMP TO Efl + 1 AND STORE P IN EA 

LOAD A 

LORD INDEX < ASSEMBLER SETS INDEX BIT> 

CONVERT A=0 TO TRUE 

CONVERT fl>=0 TO TRUE 

CONVERT fl>0 TO TRUE 

CONVERT AOO TO TRUE 

LONG LEFT LOGICAL 

LONG LEFT ROTATE 

LONG LEFT SHIFT 

CONVERT A<0 TO TRUE 

LEAVE MACHINE CHECK MODE 

CONVERT -' <A=9> TO TRUE 

LONG RIGHT LOGICAL 

LONG RIGHT ROTATE 

LONG RIGHT SHIFT 

MULT I PL V 

NO OPERATION 

NORMAL. I ZE 

OUTPUT CONTROL PULSE 

OUTPUT SERIAL. INTERFACE FROM A 

OUTPUT FROM R 

TRANSFER < OUTPUT > A TO STATUS KEVS 

POSITION FOR INTEGER DIVIDE 

POSITION FOR INTEGER MULT I PL V 

RESET C-BIT 

RESET MACHINE CHECK 

SUBTRACT TWO FROM A 

SKIP ON A BIT N RESET 

SKIP ON fl BIT N SET 

TRANSFER SHIFT COUNTER TO R 

SET C-BIT 

ENTER SINGLE PRECISION MODE 

SKIP ON fl GREATER THAN ZERO 

UNCONDITIONAL SKIP 

SKIP IF SET 

SKIP ON A LESS THAN OR EQUAL TO ZERO 

SKIP ON A BIT 16 ONE 

SKIP ON A BIT 16 ZERO 

SKIP ON MACHINE CHECK RESET 

SKIP ON MACHINE CHECK SET 

SKIP ON A MINUS 

SET INTERRUPT MASK 

SKIP ON A NOT ZERO 

SUBTRACT ONE FROM A 

SKIP ON A PLUS 

SKIP ON C-BIT RESET 

SKIP ON SENSE SWITCH N RESET 



C-2 



G 


101001 


ssc 


SKIP ON C-BIT SET 


G 


140500 


SSM 


SET SIGN OF fi MINUS 


RR 


181240+N 


SSN 


SKIP ON SENSE SWITCH N SET 


G 


140100 


SSP 


SET SIGN OF fl PLUS 


G 


100036 


SSR 


SKIP ON NONE OF SENSE SWITCHE: 


G 


101036 


SSS 


SKIP ON ANV OF SENSE SWITCHES 


MR 


04 


STA 


STORE Fl 


MR 


15 


STK 


STORE INDEX < ASSEMBLER CLEARS 


MR 


07 


SUB 


SUBTRACT MEMORY FROM A 





000505 


SVC 


SUPERVISOR CALL 


G 


100040 


SZE •: 


::SEQ> SKIP ON A ZERO 


G 


140407 


TCA 


TWO'S COMPLEMENT A 


G 


000311** 


VI.RV 


VERIFV 


G 


140104 


XCA 


TRANSFER A TO B AND CLEAR A 


G 


140204 


XOB 


TRANSFER B TO A AND CLEAR B 



:-. 1-4 SET 
1-4 SET 

S INDEX BIT> 



C-3 



APPENDIX D 
I/O DEVICE CODES 



D-l 



APPENDIX E 
ASCII CHARACTER CODES 





Octal 




Octal 




Octal 


Character 


Code 


Character 


Code 


Character 


Code 





260 


X 


330 


SOM 


201 


1 


261 


Y 


331 


EOA 


202 


2 


262 


Z 


332 


EOM 


203 


3 


263 


(blank) 


240 


EOT 


204 


4 


264 




241 


WRU 


205 


5 


265 


it 


242 


RU 


206 


6 


266 


# 


243 


BEL 


207 
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APPENDIX G 

ASSEMBLER ERROR MESSAGES 
Code Definition 

F Macro argument number not found, unrecognized 

operand type, or FAIL pseudo-op executed. 
G Improper GO TO refer^ce; or END or ENDM within a skip 

area. 
I Improper indirect flag. 
L Improper label, or external label in a literal, or 

missing label. 
M Multiply defined. 

N END within a Macro definition or an IF area. 
Unrecognized Operator. 
P Mismatched parentheses. 
Q ENDM not within a Macro definition. 
R Expression stack overflow, or improper Macro name. 
S Address out of range (LOAD mode) , or improper string 

termination. 
T Symbol table overflow. 
U Undefined variable. 

V Value is too large for field, has undefined variable, 
is missing, is illegal type, or END pseudo-op is 

within a Macro definition. 
W MAC pseudo-op is within a Macro definition. 
X Improper index tag, or improper external name. 
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APPENDIX H 
ASSEMBLER IMPROVEMENTS - DISK REVISIONS 3§4 



This appendix details additions and improvements to the assembly 
language introduced on master disk revisions 3 and 4. Information 
in this appendix was obtained from Prime internal memos PE-TN-47 
and PE-TN-50. 
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PMA IMPROVEMENTS 



The following improvements have been made in PMA for the Rev. 3 Master 
Disk: 

SUBR/ENT Logic 

PMA formerly truncated the internal name of an entry point to four 
characters when looking up the value for the entry point. The new 
SUBR logic will first search for the name as given, and then, if 
it was not found, truncate it to four characters and search again. 
Because of this change, symbol references in SUBR/ENT statements 
will not be included in the concordance. 

Multi-Word Literals 

Literal expressions may now be multi-word data items. For example: 

DAC = C 01234 5678' 
DAC = 2.51E4 

PCVH Pseudo-Op 

The PCVH pseudo-op directs the assembler to print symbol values in 
the concordance in hexadecimal instead of octal. 

Phase Error Detection 

The assembler will now flag phase errors (a symbol having a different 
value in pass 2 than in pass l) with a 'Y' error diagnostic. 

XSET Pseudo-Op 

The XSET pseudo-op is functionally equivalent to the SET pseudo-op, 
except that symbols defined with XSET will not be included in the 
concordance. 

B and v Register Attributes 

The initial value of the B and X registers at the start of an assembly 
are now available as attribute numbers 101 and 102 respectively. 
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PMA LOADER CONTROL PSEUDO-OPS 

The following loader control pseudo-ops have been added to PMA: 
D16S - Desector in 16K Sectored Mode 

The D16S pseudo-op directs the loader to enter 16K sectored 
desectorization mode. It is equivalent to the LXD pseudo-op. 

D32S - Desector in 32K Sectored Mode 

The D32S pseudo-op directs the loader to enter 32K sectored 
desectorization mode. It is equivalent to the EXD pseudo-op. 

D32R - Desector in 32K Relative Mode 

The D32R pseudo-op directs the loader to enter 32K relative 
desectorization mode. 

D64H - Desector in 64K Relative Mode 

The D64R pseudo-op directs the leader to enter 64K relative 
desectorization mode. 

SDM - Set Default Desectorization Mode 

The SDM pseudo-op directs the loader to set its default desec- 
torization mode to the mode defined by the expression in the 
variable field of the SDM pseudo-op. Legal values of the 
expression are: 

16K Sectored Mode 

1 32K Sectored Mode 

2 64K Relative Mode 

3 32K Relative Mode 

The SDM pseudo-op does not change the current desectorization 
mode. 
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DDM - Desector in Default Desectorization Mode 

The DDM pseudo-op directs the loader to enter the desectorization 
mode defined by its default desectorization mode. The default de- 
sectorization mode is initially set at the start of a load and is 
only changed by a 5DM pseudo-op. 
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REV. 4 PMA EXTENSIONS 



The following FMA extensions have been implemented for the Rev 4 
master disk: 

New Constant Forms 

The following new constant forms are now processed: 

1. Binary Constants 

A percent sign followed by a string of binary digits or 
the characters B' followed by a binary digit string fol- 
lowed by a ' will be processed as a binary constant. 



Examples : 



■B'lOl' = 5 
411011 = '33 



2. Single Character Constants 

The form R'c', where c is any character, will be processed 
as the character code of c. 



Examples 



R'A' = '301 
R' " = '247 



C64R (Check 64K Relative! Pseudo-Op 

The C64R pseudo-op directs the assembler to flag (with an 'S' 
diagnostic) any instruction that is incompatible with the 64K 
relative addressing mode. The following cases are detected: 

1. An indirect DAC 

2. An indirect jingle word memory reference instruction whose 
address is not in either sector zero or within the relative 
reach of the instruction. 
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N64R (Not 64K Relative) Pseudo-Op 

The N64R pseudo-op directs the assembler to output a flag 
in the object text to inform the loader that the program 
is not to be loaded in the 64K relative addressing mode. 
If such a program is loaded in the 64K relative addressing 
mode, the loader will report a 'N6' error. 

SETB Pseudo-Op Extension 

An additional form of the SETB pseudo-op is now processed 
to allow the size of the desectorization to be specified. 
The format is : 

SETB expl , exp2 

where: 

expl - starting address of desectorization 
area 

exp2 - size of desectorization area 

EQU, SET, and XSET Pseudo-Op Extensions 

The EQU, SET, and XSET pseudo-ops will allow the assignment 
of stack relative and external values to symbols. 

DUII (Defin e UII) Ps eudo-Op 

The DUII pseudo-op is used to trigger rhe loading of a UII 
package based on the instruction set used by previously 
loaded code and the hardware available on the machine the 
program is to execute on. The format is: 



where: 



DUII expl, exp2 



expl - bit mask defining instruction groups 
that UII package emulates 

exp2 - bit mask defining instruction sets 

that must be available for the execu- 
tion of the UII package 
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The bit assignments for instruction set options are as 
follows : 

13 - Double Precision Floating Point 

14 - Single Precision Floating Point 

15 - P300 only instructions 

16 - High Speed Arithmetic 

LIR (Load Is Required) Pseudo-Op 

The LIR is used to trigger the loading of a program based 
on the instruction groups used by previously loaded code. 
The format is : 



LIR expl 



where: 



expl - bit mask defining instruction groups 
that are to trigger loading. Bit 
assignments are the same as for DUII. 

The program will be loaded if any of the instruction groups 
specified have been used in previously loaded code. 

CENT (Condit ional E ntry) Pseudo-O p 

The CENT pseudo-op is equivalent to the ENT pseudo-op except 
that the loader will only process it if the decision to load 
a module containing a CENT pseudo-op had been made prior to 
the occurrence of the CENT statement. 

DYNM (DYNAMIC) Pseudo-O p 

The DYNM pseudo-op is used to declare stack relative symbols 
Since references to stack relative symbols generate two-word 
instructions, stack relative symbols must be declared before 
they are used. The format of A DYNM statment is: 

DYNM sl,s2, ,sN 

where: 

si = a specifier in one of the following 
formats : 



exp2 



1) 


symbol 




2) 


symbol 


(expl) 


3) 


symbol 


= exp2 


4) 


symbol 


(expl) = 


5) 


= exp2 
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In the following descriptions of the formats, the following 
abbreviations are used: 

sc - current stack allocation count (#106) (initially = 2) 

sm - maximum allocation count (#107) 

symbol - symbol to be assigned stack relative offset 

expl - expression defining number of words for symbol 

exp2 - expression defining stack offset 

1. symbol 

- symbol is assigned offset = sc 

- sc = sc + 1 

- if (sc .GT. sm) sm = sc 

2. symbol (expl) 

- symbol is assigned offset = sc 

- sc = sc + exp2 

- if (sc .GT. sm) sm = sc 

3. symbol - exp2 

- symbol is assigned offset = exp2 

- if (exp2 + 1 .GT . sm) sm = sc 

4. symbol (expl) - exp2 

- symbol is assigned offset = exp2 

- if (exp2 + expl .GT. sm) sm = exp2 + expl 

5. - exp2 

- sc = exp2 

Index Field Extensions 

The index field has been expanded to allow the specification 
of both indexing and indirection. The possible contents of 
this field are: 

,1 indexed 

, * indirect 

,1* pre-index, indirect 

,*1 indirect, post-index 
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Indirection may still be specified by an asterisk appended 
to the op-code. 

Expression Evaluation Extensions 

The following modifications have been made to the expression 
evaluator : 

1. Stack Pre-Decrement Expression 

A stack pre-decrement expression is an expression con- 
sisting only of the characters -@. It may only be used 
in the address expression of a memory reference instruc- 
tion. 

2. Stack Post-Increment Expression 

A stack post-increment expression is an expression con- 
sisting only of the characters ?+. It may only be used 
in the address expression of a memory reference instruc- 
tion. 

3. Stack Relative Special Symbol 

The symbol '@' has been the value of a zero offset from 
the stack base when used in an expression (other than in 
the preceding two special cases) . 

4. Resultant Mode of Arithmetic Operations 

All arithmetic operations other than addition and sub- 
traction will give a result mode of absolute. The 
resultant mode of an addition or subtraction operatioa 
depends on the modes of the left and right operands, as 
shown in the following tables. 

mode of right operand 



mode of 

left 

operand 



+ 


abs 


m*rel 


stack + j*rel 


abs 


abs 


m*rel 


stack + j*rel 


n*rel 


n*rel 


(m+n)*rel 


stack + 
(j+n)*rel 


stack + 
i*rel 


stack + 
i*rel 


stack + 
v/ T -ml <rel 


P 
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mode of 

left 

operand 



mode of right operand 



- 


abs 


m*rel 


stack + j*rel 


abs 


abs 


-m*rel 


P 


n*rel 


n*rel 


(n-m) *rcl 


P 


stack + 
i * re 1 


stack + 
i*rel 


stack + 
(i-m)*rel 


P 



NOTES: P = Prohibited 
l*rel = rel 
0*rel = abs 



5. Resultant Mode of Expression 

The resultant mode of an expression must be one of the 
following : 

- Absolute 

- l*rel 

- Stack + absolute 
External 

- Stack pre-decrement 

- Stack post -increment 

If the final mode of an expression is not one of the 
above, a 'Z' diagnostic will be reported. Also, the 
result mode must be one consistant with its usage. 
For example, if a relocatable expression appeared in 
the address field of a BSS statement, a 'Z' error would 
be reported since BSS cannot correctly process a relocat 
able value. 

Support of New Instruction s 

All PRIME 300 and floating point instructions will be pro- 
cessed by the assembler. 
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Generation of Special Relative Address Forms 

A special relative address form will be generated for a 
memory reference instruction if any of the following con- 
ditions are met: 

1. The address is stack relative. 

2. The address is stack pre-decrement (-@) . 

3. The address is stack post-increment (@+) . 

4. If the instruction is pre-indexed (1*) with a non- 
absolute address, or an absolute address ^ '100. 

5. The instruction is post -indexed (*1) with an absolute 
address ^- '100. 

6. If the instruction does not have a non-special relative 
form (non-zero op-code extension). 

7. A percent sign (%) is appended to the op-code. 
Assembly Listing Changes 

The following changes have been made in the assembly listing: 

1. All addresses are printed as six digits. 

2. All instruction (and address constant) addresses have a 
character appended to the end to indicate the ...ode of 
the address. The following characters are used: 

A - Absolute 

space - Relocatable 

E - External 

S - Stack Relative 

New Object Tex t Generation 

The object text generated by the assembler is in a new oinw 
only accepted by the Rev 4 (and subsequent) loaders. 
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COMM PSEUDO-OP (FORTRAN COMPATIBLE COMMON) 

This pseudo-op is for definition of FORTRAN -compatible named COMMON 
areas, which are defined downward starting from the highest location 
occupied by the loader version in use during actual loading. The 
syntax is: 

Label COM4 SI, S2, Sn 

where 'Label 1 is the name of the common block and each 's' is a 
specifier in one of the formats defined for the DYNM pseudo-operation. 
•Label' assigns a name to the block as a whole and each 's' specifies 
named variables or arrays within the block. Two counters are main- 
tained on a per common block basis - a current allocation count and 
a maximum allocation count - as in DYNM: 

Initial 
Counter Value 

sc 

sm 

Additional COMM statements with the same block name are treated as 
continuations of the earlier block. 

RLIT PSEUDO-OP (LITERALS OPTIMIZED FOR RELATIVE MODES) 

RLIT is a specification-type pseudo- operation that directs the 
assembler to handle literals in a way that is optimized for relative 
addressing modes. Normally (i.e., without RLIT), literals are 
assigned locations following a FIN or END statement. If a defined 
literal is referenced following a FIN, it is assigned another location 
following the next FIN or END statement. However, in a program that 
is proceeded by RLIT, a literal that has already been defined and is 
still within the relative or multiword reach is referenced directly. 
(A new location is not allocated.) 
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